GET
/v1/admin/ticket-tagsEvery 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 on one with tag, and put them on a
ticket with tag a ticket. Payouts have
tags of their own.
Needs a firm. Our own staff name one with the Propper-Workspace header.
Request
curl "https://api.proppertrading.com/v1/admin/ticket-tags" \
-H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f" \
-H "Propper-Workspace: acme"
Response
{
"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 |