Sign in
Agents

List agent messages

Lists messages in a thread with pagination. Returns messages in a simplified format with user, assistant, and tool messages.

post/agents/session/messages/list

Request body

idstring required

External ID of the thread to list messages for

limitinteger

Maximum number of messages to return (default 1000, max 1000)

offsetinteger

Number of messages to skip for pagination

Example request

{
  "id": "agent_conversation_thread_abc123"
}

Response

Messages retrieved successfully

totalinteger required

Total number of messages in the thread

Example response

{
  "messages": [
    {
      "parts": [
        {
          "fileId": "files_abc123"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.