Agent Messaging

The messaging API lets you send messages to agents and retrieve conversation history with cursor-based pagination.

Endpoints

Method	Endpoint	Description
`POST`	`/v1/agent/{id}/messages`	Send a message to an agent
`GET`	`/v1/agent/{id}/messages`	List messages with pagination

Queue modes: Control how the agent handles messages when busy. collect batches messages (default); interrupt cancels the current task.
Channel routing: Messages are automatically routed back through the channel they originated from (api or discord).
Cursor pagination: Use before and after parameters with message UUIDs to paginate through history.

Discord is the only external channel integration currently supported. Support for Slack, Telegram, and WhatsApp is coming soon.

For a conceptual guide on messaging patterns, see Agent Messaging & Channels.