List an agent's finished chat conversations
Website chat conversations that are no longer live, newest activity first — chat's equivalent of an agent's completed calls.
Deliberately the COMPLEMENT of the live conversations collection: a chat appears in one or the other and never both. A chat leaves the live collection when the agent finishes it, when it reaches its message limit, or when nothing has been said for 30 minutes, and it appears here from that moment until its 90-day retention expires.
endedAt is present when the agent actually finished the conversation and absent when it simply fell quiet — two different facts, so a quiet conversation carries no invented end time.
Authorization
bearerAuth A Tandem bearer token. Requests are scoped to the organization the token belongs to; no organization header is required.
In: header
Query Parameters
The agent whose conversations to list.
Page size. A larger value is clamped to the maximum rather than refused.
value <= 5020The nextCursor from a previous page. An unreadable cursor starts from the beginning rather than failing the request.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agent-media/chat-conversations?agentId=string"{ "conversations": [ { "conversationId": "string", "widgetId": "string", "startedAt": "2019-08-24T14:15:22Z", "lastActivityAt": "2019-08-24T14:15:22Z", "endedAt": "2019-08-24T14:15:22Z", "disposition": "string", "turnCount": 0 } ], "nextCursor": "string"}{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}