List desk tags

Lists the ticket tags defined for a desk

List all tags for a desk

get

Lists all ticket tags for the specified desk

Authorizations

AuthorizationstringRequired

Harmony access key, sent as Authorization: AccessKey <your-key>. Create keys in Settings > Access Keys. The tenant is resolved from the key.

Path parameters

desk_idstringRequired

Query parameters

include_countsbooleanOptional

When true, include ticket_count for each tag on this desk. Off by default to skip the extra query.

Default: false

Responses

200

Successful Response

application/json

total_countintegerRequired

422

Validation Error

application/json

get/api/v1/desks/{desk_id}/tags

GET /service-desk/api/v1/desks/{desk_id}/tags HTTP/1.1
Host: api.harmony.io
Authorization: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "id": 1,
      "desk_id": "text",
      "name": "text",
      "color": "text",
      "description": "text",
      "system_tag": true,
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z",
      "ticket_count": 1
    }
  ],
  "total_count": 1
}