Conversations
Get Agent Conversations
Conversations
Get Agent Conversations
Get all conversations for an agent.
GET
/
api
/
v1
/
agents
/
{agentId}
/
conversations
Retrieve all information about an agent’s conversations.
Response Headers for Pagination
| Header Name | Type | Description |
|---|---|---|
X-Page-Size | integer | The number of items per page. |
X-Start-After | string | The ID of the last item on the previous page. |
X-Next-Start-After | string | The ID of the last item on the current page. |
X-Total-Count | integer | The total number of items. |
These headers are included in the response to help manage pagination when retrieving conversations for a specific agent.
Authorizations
AUTHORIZATION
string
headerrequiredAPI key required for this endpoint. Use Bearer YOUR_SECRET_API_KEY. Get your key from https://play.ai/developers.
X-USER-ID
string
headerrequiredUser ID required for this endpoint. Get it from https://play.ai/developers.
Headers
accept
enum<string>
Available options:
application/json Path Parameters
agentId
string
requiredThe agent's ID.
Query Parameters
pageSize
integer
default: 50The number of items to return per page.
startAfter
string
The conversation ID to start after.
Response
200 - application/json
id
string
source
string
callerEmail
string
startedAt
string
endedAt
string
durationInSeconds
integer