# Conversations API

Read and reply to inbox conversations, assign them, and change their status and priority.

- [List conversations](https://www.nabrah.ai/en/docs/api-reference/conversations/list-conversations.md) `GET /api/ext/omni_v2/conversation/conversation`: Returns a paginated list of conversations (omnichannel inbox threads) for the project that owns the API key.
- [Filter conversations](https://www.nabrah.ai/en/docs/api-reference/conversations/filter-conversations.md) `POST /api/ext/omni_v2/conversation/conversation/filter`: Lists conversations matching a structured filter expression supplied in the JSON body, returning the same response shape as the generic list endpoint (meta folder counts plus a payload array of conversation summaries).
- [List conversations by contact](https://www.nabrah.ai/en/docs/api-reference/conversations/list-conversations-by-contact.md) `POST /api/ext/omni_v2/conversation/conversation/contact/{contact_id}`: Lists conversations belonging to the contact identified by contact_id, with optional server-side filtering supplied in the request body and pagination via the page query parameter.
- [Get conversation](https://www.nabrah.ai/en/docs/api-reference/conversations/get-conversation.md) `GET /api/ext/omni_v2/conversation/conversation/{id}`: Returns the full detail of a single conversation thread, including its metadata, the contact/sender and assignee in meta, the last_non_activity_message, and an embedded messages array.
- [List conversation messages](https://www.nabrah.ai/en/docs/api-reference/conversations/list-conversation-messages.md) `GET /api/ext/omni_v2/conversation/conversation/{id}/messages`: Returns a page of messages for the conversation, newest-relevant first, using cursor-based pagination via the before query parameter.
- [Send a message](https://www.nabrah.ai/en/docs/api-reference/conversations/send-a-message.md) `POST /api/ext/omni_v2/conversation/conversation/{id}/messages`: Sends a new message into the conversation.
- [Send a message with an attachment](https://www.nabrah.ai/en/docs/api-reference/conversations/send-a-message-with-an-attachment.md) `POST /api/ext/omni_v2/conversation/conversation/{id}/messages_with_attachment`: Sends a message into the conversation with a file attachment.
- [List conversation attachments](https://www.nabrah.ai/en/docs/api-reference/conversations/list-conversation-attachments.md) `GET /api/ext/omni_v2/conversation/conversation/{id}/attachments`: Returns every attachment shared in the conversation across all of its messages, in a single flat list.
- [Assign conversation](https://www.nabrah.ai/en/docs/api-reference/conversations/assign-conversation.md) `POST /api/ext/omni_v2/conversation/conversation/{id}/assign`: Assigns the conversation to a workspace member (agent).
- [Change conversation status](https://www.nabrah.ai/en/docs/api-reference/conversations/change-conversation-status.md) `POST /api/ext/omni_v2/conversation/conversation/{id}/toggle_status`: Changes the lifecycle status of the conversation.
- [Change conversation priority](https://www.nabrah.ai/en/docs/api-reference/conversations/change-conversation-priority.md) `POST /api/ext/omni_v2/conversation/conversation/{id}/toggle_priority`: Sets the priority of the conversation.
- [Mark conversation as seen](https://www.nabrah.ai/en/docs/api-reference/conversations/mark-conversation-as-seen.md) `POST /api/ext/omni_v2/conversation/conversation/{id}/update_last_seen`: Marks the conversation as seen by the agent/assignee, updating the server-side last-seen timestamp and clearing the unread state for the agent side.