Sign in
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

Changes

Changed in 3 of the 15 revisions of this API.113

  • 5798f431973a12See the full diff
    • ●

      added the new tool_call enum value to the conversation/messages/items/messageType response property for the response status 200

      response-property-enum-value-added

    • ○

      added the optional property conversation/messages/items/parts to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property conversation/messages/items/reasoning to the response with the 200 status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 8255239599bf1See the full diff
    • ○

      added the optional property conversation/messages/items/tools to the response with the 200 status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 911a57b55d181See the full diff
    • ▲

      the response property conversation/messages/items/confidence became nullable for the status 200

      response-property-became-nullable