:::endpoint GET /v1/admin/ticket-tags

Every tag the firm made for tickets, by name, with how many tickets carry it.
The team's own labels: what a ticket is about, so it can be found and counted.
Traders never see them, and they never change a status. A firm has a handful,
so the list comes whole, without pages.

Filter the [list](/docs/api/admin/tickets) on one with `tag`, and put them on a
ticket with [tag a ticket](/docs/api/admin/ticket-tags-set). Payouts have
[tags of their own](/docs/api/admin/payout-tags).

Needs a firm. Our own staff name one with the `Propper-Workspace` header.

## Request

```bash
curl "https://api.proppertrading.com/v1/admin/ticket-tags" \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f" \
  -H "Propper-Workspace: acme"
```

## Response

```json
{
    "data": [
        { "object": "ticket_tag", "id": "ttag_kr5xp9kr8ykuz5mr", "name": "Billing", "color": "amber", "count": 1 },
        { "object": "ticket_tag", "id": "ttag_6fjgbatb6fxzafc8", "name": "Payout", "color": "emerald", "count": 17 }
    ],
    "meta": {
        "request_id": "req_01m50v0tp686pw0wdht9bv68tj",
        "has_more": false,
        "next_cursor": null
    }
}
```

| Field   | Description |
| ------- | ----------- |
| `name`  | Unique within the firm, up to 50 characters |
| `color` | `gray`, `red`, `orange`, `amber`, `emerald`, `cyan`, `blue`, `violet` or `pink` |
| `count` | How many tickets carry it, ended ones included |

## Errors

| Status | Code                      | Meaning                                                                         |
| ------ | ------------------------- | ------------------------------------------------------------------------------- |
| 400    | `workspace_required`      | Asked by our own staff without naming a firm                                    |
| 401    | `invalid_token`           | Not a token, or the secret does not match                                       |
| 401    | `revoked_token`           | Signed out here or from another device                                          |
| 401    | `expired_token`           | Ninety days without use, or a set expiry passed                                 |
| 403    | `admin_access_required`   | This account no longer helps run the environment                                |
| 403    | `insufficient_scope`      | This device does not hold `admin:read`                                          |
| 403    | `workspace_not_permitted` | The `Propper-Workspace` header names an environment this account cannot act in |
| 403    | `forbidden`               | Without `view_tickets`                                                          |