Agents
Get agent conversation by ID
Returns the conversation with paginated/sorted messages and filter metadata.
Message Pagination:
Messages are paginated newest-first: page=1 returns the most recent batch. Increment page to load older batches (used by the infinite-scroll "load older messages" feature).
- page: Page number (default: 1)
- limit: Messages per page (default: 20, max: 100)
get/agents/{agentKey}/conversations/{conversationId}
Path parameters
agentKeystring required
conversationIdstring objectId required
Query parameters
pageinteger
Page number for message pagination (1 = most recent batch)
limitinteger
Number of messages per page
sortBy'createdAt' | 'messageType' | 'content'
Field to sort messages by
sortOrder'asc' | 'desc'
Sort direction
startDatestring date-time
Filter messages created on or after this date
endDatestring date-time
Filter messages created on or before this date
messageType'user_query' | 'bot_response' | 'error' | 'feedback' | 'system'
Filter messages by type
Response
Agent conversation detail