# conversations

> Inbox conversations: assignment, status, notes, labels, AI mode.

Inbox conversations: assignment, status, notes, labels, AI mode.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/conversations` | `conversations_list`: List and filter conversations | `conversations:read` | yes |
| POST | `/v1/conversations` | `conversations_create`: Open a conversation with a contact on a channel | `conversations:write` | - |
| GET | `/v1/conversations/{conversation_id}` | `conversations_get`: Get a conversation | `conversations:read` | yes |
| PATCH | `/v1/conversations/{conversation_id}` | `conversations_update`: Update priority, subject and custom attributes | `conversations:write` | yes |
| GET | `/v1/conversations/{conversation_id}/ai` | `conversations_ai_get`: AI state of a conversation | `conversations:read` | - |
| POST | `/v1/conversations/{conversation_id}/ai/pause` | `conversations_ai_pause`: Pause the bot for this chat (human takeover) | `conversations:write` | - |
| POST | `/v1/conversations/{conversation_id}/ai/resume` | `conversations_ai_resume`: Resume the bot | `conversations:write` | - |
| POST | `/v1/conversations/{conversation_id}/ai/suggest-replies` | `conversations_ai_suggest_replies`: Suggested replies | `ai:read` | - |
| POST | `/v1/conversations/{conversation_id}/ai/summarize` | `conversations_ai_summarize`: Summarise the conversation | `ai:read` | - |
| POST | `/v1/conversations/{conversation_id}/ai/translate` | `conversations_ai_translate`: Translate messages | `ai:read` | - |
| POST | `/v1/conversations/{conversation_id}/assign` | `conversations_assign`: Assign to a user or team (or unassign) | `conversations:write` | - |
| POST | `/v1/conversations/{conversation_id}/auto-assign` | `conversations_auto_assign`: Apply the routing rule | `conversations:write` | - |
| POST | `/v1/conversations/{conversation_id}/close` | `conversations_close`: Resolve or close | `conversations:write` | yes |
| POST | `/v1/conversations/{conversation_id}/labels` | `conversations_labels_add`: Add labels | `conversations:write` | - |
| DELETE | `/v1/conversations/{conversation_id}/labels/{label_id}` | `conversations_labels_remove`: Remove a label | `conversations:write` | - |
| POST | `/v1/conversations/{conversation_id}/lane` | `conversations_set_lane`: Mark a chat private or business (owner only) | `conversations:write` | - |
| GET | `/v1/conversations/{conversation_id}/notes` | `conversations_notes_list`: Internal notes | `conversations:read` | yes |
| POST | `/v1/conversations/{conversation_id}/notes` | `conversations_notes_create`: Add an internal note | `conversations:write` | yes |
| DELETE | `/v1/conversations/{conversation_id}/notes/{note_id}` | `conversations_notes_delete`: Delete a note | `conversations:write` | yes |
| GET | `/v1/conversations/{conversation_id}/notes/{note_id}` | `conversations_notes_get`: Get an internal note | `conversations:read` | yes |
| PATCH | `/v1/conversations/{conversation_id}/notes/{note_id}` | `conversations_notes_update`: Edit a note | `conversations:write` | yes |
| GET | `/v1/conversations/{conversation_id}/participants` | `conversations_participants_list`: Agents who handled the chat, and watchers | `conversations:read` | - |
| POST | `/v1/conversations/{conversation_id}/read` | `conversations_mark_read`: Mark as read | `conversations:write` | yes |
| POST | `/v1/conversations/{conversation_id}/reopen` | `conversations_reopen`: Reopen a resolved conversation | `conversations:write` | yes |
| DELETE | `/v1/conversations/{conversation_id}/snooze` | `conversations_unsnooze`: Unsnooze | `conversations:write` | yes |
| POST | `/v1/conversations/{conversation_id}/snooze` | `conversations_snooze`: Snooze until a time | `conversations:write` | yes |
| POST | `/v1/conversations/{conversation_id}/transfer-to-meta-agent` | `conversations_transfer_to_meta_agent`: Pass thread control to Meta's agent or a partner app | `conversations:write` | - |
| POST | `/v1/conversations/{conversation_id}/typing` | `conversations_typing`: Typing indicator | `messages:send` | - |
| POST | `/v1/conversations/{conversation_id}/watchers` | `conversations_watchers_add`: Follow a conversation | `conversations:write` | - |

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