Tickets

📄️ List project ticket statuses

Ticket statuses (kanban columns) of a project, ordered. Use a returned status `id` when creating/updating a ticket. Requires `api_user|ticket_status_view`.

📄️ List project tickets

Paginated tickets of a project. Filters: priority, assigned_to, created_at (single date or 'start,end'), number (contact phone number; last 10 significant digits matched), `form[<key>]` (the ticket's own dynamic fields), `contact[<column>]` and `contact_form[<key>]` (the linked contact), and a generic `search` (ticket_key). Different keys are AND-ed, values of one key are OR-ed. At most 5 fields per request in total across `form` and `contact_form` (the whole `contact` block counts as one), and at most 50 values per field. Requires `api_user|ticket_view`.

📄️ Create a ticket

Creates a ticket in the project (generates ticket_key/number/order). `form_values` custom fields are validated (required enforced). Multi-valued fields (`checkbox`, `select`, `autocomplete`) must be sent as an array even for a single value (`['option-1']`); a scalar is rejected with 422. Requires `api_user|ticket_create`.

📄️ Ticket custom field schema

Dynamic (custom) form fields attached to the project's tickets. `key` values are the ones accepted by the ticket list `form[<key>]` filter. Returns an empty `fields` list when the project has no form. Requires `api_user|ticket_view`.

📄️ Show a ticket

Returns a ticket with status, assignee, contact, tags and custom form values. Requires `api_user|ticket_view`.

📄️ Delete a ticket

Soft-deletes the ticket. Requires `api_user|ticket_delete`.

📄️ Update a ticket (partial)

Partial update: send only the fields you want to change (at least one is required). `assigned_to` sent as null unassigns; `tags` replaces the tag set; `form_values` upserts only the submitted custom fields (no required enforcement). Multi-valued fields (`checkbox`, `select`, `autocomplete`) must be sent as an array even for a single value (`['option-1']`); a scalar is rejected with 422. Requires `api_user|ticket_update`.