> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shinzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Messaging Overview

> Send messages to agents and retrieve conversation history.

# 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`](/api/agents/send-message)  | Send a message to an agent    |
| `GET`  | [`/v1/agent/{id}/messages`](/api/agents/list-messages) | List 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.

<Info>
  **Supported channels**: Discord, Slack, and Telegram are fully supported. WhatsApp support is coming soon.
</Info>

For a conceptual guide on messaging patterns, see [Agent Messaging & Channels](/agents/messaging).