Tags

Overview

Tags are workspace-level labels you can attach to tickets. The API exposes full CRUD (admin required to create, update, or delete).

List Tags

GET /api/tags

Example Response

{
    "data": [
        { "id": 1, "ulid": "01hx9f3k2a...", "name": "billing", "color": "#fbbf24" },
        { "id": 2, "ulid": "01hx9f3k2b...", "name": "bug", "color": "#ef4444" }
    ]
}

Show Tag

GET /api/tags/{tag}

Create Tag (admin only)

POST /api/tags

Request Body

Field	Type	Required	Description
`name`	string	Yes	Tag name
`color`	string	Yes	Hex color, e.g. `#2563eb`

Update Tag (admin only)

PUT /api/tags/{tag}

Same body as create.

Delete Tag (admin only)

DELETE /api/tags/{tag}

Returns 204 on success.

Attach or Detach a Tag on a Ticket

POST /api/tickets/{ticket}/tags/{tag}
DELETE /api/tickets/{ticket}/tags/{tag}

These endpoints accept no request body.