Add Tags
PUT {{baseUrl}}/api/v2/tickets/:ticket_id/tags
You can also add tags to multiple tickets with the Update Many Tickets endpoint.
Safe Update
If the same ticket is updated by multiple API requests at
the same time, some tags could be lost because of ticket
update collisions. Include updated_stamp
and safe_update
properties in the request body to make a safe update.
For updated_stamp
, retrieve and specify the ticket's
latest updated_at
timestamp. The tag update only occurs
if the updated_stamp
timestamp matches the ticket's
actual updated_at
timestamp at the time of the request.
If the timestamps don't match (in other words, if the
ticket was updated since you retrieved the ticket's
last updated_at
timestamp), the request returns a
409 Conflict error.
Example
{
"tags": ["customer"],
"updated_stamp":"2019-09-12T21:45:16Z",
"safe_update":"true"
}
For details, see Protecting against ticket update collisions.
Allowed For
- Agents
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"tags":["urgent","printer","fire"]}