List Messages

GET
/v1/agents/:agent_id/messages

Retrieve message history for an agent.

Path parameters

agent_idstringRequired

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.

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 null
OR
User Messageobject or null
OR
Reasoning Messageobject or null
OR
Tool Call Messageobject or null
OR
Tool Return Messageobject or null
OR
Assistant Messageobject or null

Errors

Send Message
Built with