Tags

Labels used to organise posts within a workspace.

📄️List tags

Returns every tag in the workspace, newest first. This endpoint is not paginated and accepts no query parameters — it always returns the full set. Requires the ADMIN or MEMBER workspace role; the VIEWER role receives `403`.

📄️Create a tag

Creates a tag in the workspace. Both `name` and `hex_color` are required. Returns `201 Created` with the new tag. Requires the ADMIN or MEMBER workspace role; the VIEWER role receives `403`.

📄️Get a tag

Returns a single tag by its UUID. The response is a bare object (not wrapped in `data`). Requires the ADMIN or MEMBER workspace role; the VIEWER role receives `403`.

📄️Update a tag

Updates a tag's name and colour. Both fields are required — this is a full replace, not a partial patch. Requires the ADMIN or MEMBER workspace role; the VIEWER role receives `403`.

📄️Delete a tag

Deletes a tag. Requires the ADMIN or MEMBER workspace role; the VIEWER role receives `403`.