List Messages

Retrieve message history for an agent.

Path parameters

agent_idstringRequired

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Query parameters

afterstringOptional

Message after which to retrieve the returned messages.

beforestringOptional

Message before which to retrieve the returned messages.

limitintegerOptionalDefaults to 10

Maximum number of messages to retrieve.

group_idstringOptional

Group ID to filter messages by.

use_assistant_messagebooleanOptionalDefaults to true

Whether to use assistant messages

assistant_message_tool_namestringOptionalDefaults to send_message

The name of the designated message tool.

assistant_message_tool_kwargstringOptionalDefaults to message

The name of the message argument.

Response

Successful Response

System Messageobject
OR
User Messageobject
OR
Reasoning Messageobject
OR
Hidden Reasoning Messageobject
OR
Tool Call Messageobject
OR
Tool Return Messageobject
OR
Assistant Messageobject

Errors