# messages

> Send and read messages on every channel through one policy-checked pipeline.

Send and read messages on every channel through one policy-checked pipeline.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/conversations/{conversation_id}/messages` | `messages_list`: List a conversation's messages | `messages:read` | yes |
| POST | `/v1/conversations/{conversation_id}/messages` | `messages_send_in_conversation`: Send a message in a conversation | `messages:send` | yes |
| POST | `/v1/conversations/{conversation_id}/messages/interactive` | `messages_send_interactive`: Send an interactive message | `messages:send` | yes |
| POST | `/v1/conversations/{conversation_id}/messages/media` | `messages_send_media`: Send media by media_id | `messages:send` | - |
| POST | `/v1/conversations/{conversation_id}/messages/template` | `messages_send_template`: Send a template | `messages:send` | yes |
| POST | `/v1/conversations/{conversation_id}/messages/text` | `messages_send_text`: Send a text message | `messages:send` | yes |
| POST | `/v1/messages` | `messages_send`: Send a message (policy engine, then queued) | `messages:send` | yes |
| POST | `/v1/messages:estimate` | `messages_estimate`: Pre-flight check for a send | `messages:read` | yes |
| DELETE | `/v1/messages/{message_id}` | `messages_delete`: Delete / revoke a message | `messages:send` | - |
| GET | `/v1/messages/{message_id}` | `messages_get`: Get a message | `messages:read` | yes |
| GET | `/v1/messages/{message_id}/media` | `messages_media_get`: Short-lived signed URL for a message's media | `messages:read` | - |
| DELETE | `/v1/messages/{message_id}/reactions` | `messages_unreact`: Remove our reaction | `messages:send` | yes |
| POST | `/v1/messages/{message_id}/reactions` | `messages_react`: React to a message | `messages:send` | yes |
| POST | `/v1/messages/{message_id}/retry` | `messages_retry`: Retry a failed send | `messages:send` | yes |
| POST | `/v1/messages/{message_id}/transcribe` | `messages_transcribe`: Transcribe a voice note | `ai:read` | - |
| POST | `/v1/messages/{message_id}/translate` | `messages_translate`: Translate a message | `ai:read` | - |
| POST | `/v1/messages/batch` | `messages_batch`: Send up to 100 messages | `messages:send` | yes |
| GET | `/v1/messages/search` | `messages_search`: Full-text message search | `messages:read` | yes |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
