List Messages

Retrieve message history for an agent.

Path parameters

agent_idstringRequired

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Query parameters

afterstring or nullOptional
Message after which to retrieve the returned messages.
beforestring or nullOptional
Message before which to retrieve the returned messages.
limitintegerOptionalDefaults to 10
Maximum number of messages to retrieve.
group_idstring or nullOptional
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.
include_errboolean or nullOptional
Whether to include error messages and error statuses. For debugging purposes only.

Response

Successful Response
SystemMessageobject
OR
UserMessageobject
OR
ReasoningMessageobject
OR
HiddenReasoningMessageobject
OR
ToolCallMessageobject
OR
ToolReturnMessageobject
OR
AssistantMessageobject

Errors