list-ticket-tags
dci list-ticket-tags ticketId
Returns the tags currently set on a support request.
DoiT employee (doer) callers receive the full tag set verbatim,
including internal namespaces (e.g. tier/*, synapse_*). Customer
callers receive only tags under the customer_tag/ namespace, with
that prefix stripped (e.g. a tag added as billing reads back as
billing). Always present; empty array when the caller has no visible
tags.
Output
OK
By default dci renders the result as a table. Use --output json to get the full structure described below — see Output formats.
| Field | Type | Description |
|---|---|---|
tags | array of string | Ticket tags, filtered by caller type. DoiT employee (doer) callers receive the full tag set verbatim, including internal namespaces (e.g. tier/*, synapse_*). Customer callers receive only tags under the customer_tag/ namespace, with that prefix stripped. Always present; empty array when the caller has no visible tags. |
Raw JSON schema
{
"type": "object",
"description": "Response body for GET /support/v1/tickets/{ticketId}/tags. Contains\nthe current tags visible to the caller.",
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Ticket tags, filtered by caller type. DoiT employee (doer) callers\nreceive the full tag set verbatim, including internal namespaces\n(e.g. `tier/*`, `synapse_*`). Customer callers receive only tags\nunder the `customer_tag/` namespace, with that prefix stripped.\nAlways present; empty array when the caller has no visible tags."
}
}
}
Errors
On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.
| HTTP status | Exit code | Error code | Meaning |
|---|---|---|---|
| 400 | 30 | VALIDATION_ERROR | The arguments or request body were rejected. Review the command's flags and payload. |
| 401 | 10 | AUTHENTICATION_FAILED | Not signed in, or the API token is invalid. Run dci login or check DCI_API_KEY. |
| 403 | 11 | PERMISSION_DENIED | The DoiT user or the active customer context does not have access. |
| 404 | 20 | RESOURCE_NOT_FOUND | The requested resource does not exist. Check the identifier argument. |
Aliases: listtickettags