Ticket tags

Tags let you categorize tickets within an inbox. A ticket can have multiple tags. Tag ids start with tag_. The {id} path parameter is the ticket id; SUP- client ids are also accepted (see Tickets > Identifiers).

List ticket tagsGET/v1/tickets/{id}/tags

Permission: read. Returns all tags assigned to the ticket.

01{
02  "data": [ { "id": "tag_7g8h...", "name": "Billing", "color": "#22c55e" } ],
03  "count": 1
04}

Assign a tagPOST/v1/tickets/{id}/tags

Permission: write. Body: { "tag_id": "tag_..." }. The tag must belong to an inbox of your workspace (404 otherwise). Returns 201 with { "success": true }, or 409 if the tag is already assigned. Triggers automation rules subscribed to tag_assigned.

01curl https://api.tickos.dev/v1/tickets/{id}/tags \
02  -H 'Authorization: Bearer sk_your_api_key' \
03  -H 'Content-Type: application/json' \
04  -d '{ "tag_id": "tag_7g8h..." }'

Remove a tagDELETE/v1/tickets/{id}/tags

Permission: write. The tag is sent in the JSON request body: { "tag_id": "tag_..." } (400 if missing). Returns 200 with { "success": true }, also when the tag was not assigned to the ticket.

01curl -X DELETE https://api.tickos.dev/v1/tickets/{id}/tags \
02  -H 'Authorization: Bearer sk_your_api_key' \
03  -H 'Content-Type: application/json' \
04  -d '{ "tag_id": "tag_7g8h..." }'