Tickets

Update ticket inbox

Updates the ticket inbox configuration for the project tied to your API key and returns the resulting inbox object. Send the new settings inside the config object; fields control auto-assignment, the catalog of allowed ticket types, whether every inbound conversation always opens a ticket, the pool of agents eligible for assignment, and whether a contact is locked to a single open ticket.

PATCH

https://api.nabrah.ai/api/ext/omni_v2/ticket/inboxes

Update ticket inbox

curl --request PATCH \
  --url 'https://api.nabrah.ai/api/ext/omni_v2/ticket/inboxes' \
  --header 'X-API-Key: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "config": {
    "auto_assign": true,
    "ticket_types": [
      "support",
      "billing",
      "sales"
    ],
    "alway_create_ticket": false,
    "assign_list": [
      "user_7c19a2",
      "user_3ab8f1"
    ],
    "lock_to_single_open_ticket": true
  }
}'

{
  "id": 0,
  "inbox_type": "whatsapp",
  "inbox_id": 0,
  "project_id": "00000000-0000-4000-8000-000000000000",
  "name": "string",
  "config": {},
  "created_at": "2026-01-15T12:00:00.000Z"
}

Config fields

config

auto_assign toggles automatic assignment of new tickets. ticket_types is the list of allowed categories (these are the valid values for a ticket's ticket_type). alway_create_ticket (note the spelling) forces a ticket for every inbound conversation. assign_list is the pool of user ids eligible for auto-assignment. lock_to_single_open_ticket prevents a contact from having more than one open ticket at a time.

auto_assignticket_typesalway_create_ticketassign_listlock_to_single_open_ticket

Returns a GetInboxResponse — the updated inbox object (id, inbox_type, inbox_id, project_id, name, config, created_at).

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Body

application/json

Update the inbox ticketing configuration.

Example

{
  "config": {
    "auto_assign": true,
    "ticket_types": [
      "support",
      "billing",
      "sales"
    ],
    "alway_create_ticket": false,
    "assign_list": [
      "user_7c19a2",
      "user_3ab8f1"
    ],
    "lock_to_single_open_ticket": true
  }
}

Response

200

Successful Response

application/json

422

Validation Error

application/json