Skip to main content
GET
/
agents
/
{agentId}
/
users
/
{userId}
/
conversations
List conversations for a user
curl --request GET \
  --url https://www.chatbase.co/api/v2/agents/{agentId}/users/{userId}/conversations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "title": "<string>",
      "createdAt": 123,
      "updatedAt": 123,
      "userId": "<string>"
    }
  ],
  "pagination": {
    "cursor": "<string>",
    "hasMore": true,
    "total": 123
  }
}

Authorizations

​
Authorization
string
header
required

API key from your account settings

Path Parameters

​
agentId
string
required

The agent ID

Minimum string length: 1
Example:

"5QHA6VB-DIAbBhxwqxfdi"

​
userId
string
required

The user ID (URL-safe characters only: letters, digits, hyphens, underscores, dots)

Required string length: 1 - 128
Pattern: ^[a-zA-Z0-9._-]+$
Example:

"user_abc123"

Query Parameters

​
cursor
string

Opaque cursor from a previous response to fetch the next page

Example:

"eyJ0IjoiMjAyNC0wMS0xNVQxMDozMDowMC4wMDBaIiwiaWQiOiJhYmMxMjMifQ=="

​
limit
integer
default:20

Number of items per page (1–100, default 20)

Required range: 1 <= x <= 100
Example:

20

Response

Paginated list of user conversations

​
data
object[]
required
​
pagination
object
required