Skip to main content

​
Agent Messaging

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

​
Endpoints

MethodEndpointDescription
POST/v1/agent/{id}/messagesSend a message to an agent
GET/v1/agent/{id}/messagesList messages with pagination

​
Key Concepts

  • 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, discord, slack, telegram, or agent).
  • Cursor pagination: Use before and after parameters with message UUIDs to paginate through history.
Supported channels: Discord, Slack, and Telegram are fully supported. WhatsApp support is coming soon.
For a conceptual guide on messaging patterns, see Agent Messaging & Channels.