# Tickets API

Create and work support tickets, and configure the inboxes they arrive in.

- [Create ticket](https://www.nabrah.ai/en/docs/api-reference/tickets/create-ticket.md) `POST /api/ext/omni_v2/ticket`: Creates a new support ticket (conversation) and returns the full ticket object including its server-assigned id, inbox, status, priority, and any seeded message.
- [List tickets](https://www.nabrah.ai/en/docs/api-reference/tickets/list-tickets.md) `GET /api/ext/omni_v2/ticket`: Returns a paginated list of support tickets (conversations) for the project tied to your API key, with a meta object holding live counts by assignee bucket and a payload array of ticket objects.
- [Filter tickets](https://www.nabrah.ai/en/docs/api-reference/tickets/filter-tickets.md) `POST /api/ext/omni_v2/ticket/filter`: Lists tickets using a structured server-side filter supplied in the request body, returning the same meta/payload shape as the generic list endpoint.
- [List tickets by contact](https://www.nabrah.ai/en/docs/api-reference/tickets/list-tickets-by-contact.md) `POST /api/ext/omni_v2/ticket/contact/{contact_id}`: Lists tickets associated with the contact identified by contact_id, with optional server-side filtering in the request body and pagination via the page query parameter.
- [Get ticket](https://www.nabrah.ai/en/docs/api-reference/tickets/get-ticket.md) `GET /api/ext/omni_v2/ticket/{id}`: Fetches a single ticket by its numeric id and returns the full ticket object: lifecycle status, priority, assignee and sender metadata, labels, the latest non-activity message, and an embedded messages array.
- [List ticket messages](https://www.nabrah.ai/en/docs/api-reference/tickets/list-ticket-messages.md) `GET /api/ext/omni_v2/ticket/{id}/messages`: Returns the message history for a ticket, ordered for display, along with a meta block describing the contact, labels, and seen timestamps.
- [Add a ticket message](https://www.nabrah.ai/en/docs/api-reference/tickets/add-a-ticket-message.md) `POST /api/ext/omni_v2/ticket/{id}/messages`: Adds a new message to the ticket identified by path id and returns the created message object (id, content, sender, type, timestamps).
- [Add a ticket message with attachments](https://www.nabrah.ai/en/docs/api-reference/tickets/add-a-ticket-message-with-attachments.md) `POST /api/ext/omni_v2/ticket/{id}/messages_with_attachment`: Adds a new message to the ticket identified by path id with one or more file attachments (images, PDFs, etc.), and returns the created message object including its attachments.
- [Assign ticket](https://www.nabrah.ai/en/docs/api-reference/tickets/assign-ticket.md) `POST /api/ext/omni_v2/ticket/{id}/assign`: Assigns the ticket identified by path id to a specific agent/user.
- [Change ticket status](https://www.nabrah.ai/en/docs/api-reference/tickets/change-ticket-status.md) `POST /api/ext/omni_v2/ticket/{id}/toggle_status`: Changes the lifecycle status of the ticket identified by path id.
- [Change ticket priority](https://www.nabrah.ai/en/docs/api-reference/tickets/change-ticket-priority.md) `POST /api/ext/omni_v2/ticket/{id}/toggle_priority`: Sets (toggles) the priority of the ticket identified by path id.
- [Change ticket type](https://www.nabrah.ai/en/docs/api-reference/tickets/change-ticket-type.md) `POST /api/ext/omni_v2/ticket/{id}/update_type`: Updates the category (type) of the ticket identified by path id.
- [Create ticket inbox](https://www.nabrah.ai/en/docs/api-reference/tickets/create-ticket-inbox.md) `POST /api/ext/omni_v2/ticket/inboxes`: Creates a ticket inbox for the project tied to your API key and returns the created inbox object including its server-assigned id.
- [List ticket inboxes](https://www.nabrah.ai/en/docs/api-reference/tickets/list-ticket-inboxes.md) `GET /api/ext/omni_v2/ticket/inboxes`: Lists the ticket inboxes configured for the project tied to your API key.
- [Update ticket inbox](https://www.nabrah.ai/en/docs/api-reference/tickets/update-ticket-inbox.md) `PATCH /api/ext/omni_v2/ticket/inboxes`: Updates the ticket inbox configuration for the project tied to your API key and returns the resulting inbox object.
- [Delete ticket inbox](https://www.nabrah.ai/en/docs/api-reference/tickets/delete-ticket-inbox.md) `DELETE /api/ext/omni_v2/ticket/inboxes`: Deletes the ticket inbox configuration for the project tied to your API key and returns a boolean indicating success.