Skip to navigation
Threads

List Messages

Get the chat history for a thread.

This endpoint retrieves the message history for a thread. You can optionally filter messages by date range using start and end parameters, and paginate results using start_index and limit_num. If no date filters are provided, all messages in the thread are returned.

The response includes all messages in chronological order, with user messages and AI responses clearly identified.

For example, use with start_index=0&limit_num=25 to get the latest 25 messages.

Authentication

AuthorizationBearer
OAuth2 access token obtained via token exchange.

Path parameters

thread_idstringRequired

Query parameters

startdatetime or nullOptional
enddatetime or nullOptional
start_indexintegerOptionalDefaults to 0
limit_numinteger or nullOptional

Response

Successful Response
messageslist of objects
total_message_countintegerOptional
start_indexintegerOptionalDefaults to 0

Errors

422
Unprocessable Entity Error