Skip to main content
GET
/
api
/
agents
/
{agentId}
/
conversations
List conversations for an agent
curl --request GET \
  --url http://localhost:3000/api/agents/{agentId}/conversations \
  --header 'Authorization: Bearer <token>'

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
agentId
string
required

Agent ID

Query Parameters

​
page
number
default:1

Page number (1-based)

Required range: x >= 1
Example:

1

​
limit
number
default:20

Number of items per page

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

20

​
search
string

Search term to filter results

Maximum string length: 100
Example:

"john"

​
sortBy
string

Field to sort by

Example:

"createdAt"

​
sortOrder
enum<string>
default:desc

Sort order

Available options:
asc,
desc
Example:

"desc"

​
status
enum<string>

Filter by status

Available options:
pending,
active,
ended,
failed,
archived

Response

List of conversations