Sign in
Conversations

Get conversation by ID

Retrieve a specific conversation with its full message history.

Overview:

Returns the complete conversation including all messages, citations, feedback, and metadata. Messages can be paginated for long conversations.

Message Pagination:

For conversations with many messages, use pagination parameters:

  • page: Page number (default: 1)
  • limit: Messages per page (default: 10)
  • sortBy: Sort field (default: createdAt)
  • sortOrder: 'asc' or 'desc' (default: desc)

Access Control:

Users can access conversations they own or that have been shared with them.

get/conversations/{conversationId}

Path parameters

conversationIdstring objectId required

Unique conversation identifier

Query parameters

pageinteger

Page number for message pagination

limitinteger

Number of messages per page

sortBy'createdAt' | 'messageType' | 'content'

Field to sort messages by

sortOrder'asc' | 'desc'

Sort direction

searchstring

Case-insensitive search across conversation title and message content

startDatestring date-time

Filter messages created on or after this date (ISO 8601)

endDatestring date-time

Filter messages created on or before this date (ISO 8601)

sharedboolean

Filter by shared status of the conversation

messageType'user_query' | 'bot_response' | 'error' | 'feedback' | 'system'

Filter messages by type

Response

Conversation with paginated messages, applied filter metadata, and request metadata

Changes

Changed in 1 of the 15 revisions of this API.13

  • 5798f431973a13See 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

    • ○

      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