Tags

Full field reference (types, enums, required/read-only flags) is generated from components.schemas.Tag in the API Reference tab, and tabulated field by field — with what each one's read-only status means for a write — in Field Reference. Or fetch the live OpenAPI document directly, see Getting Started for the URL.

GET /tags · GET /tags/:tagId

{
  "id": "b94cb9cfd06d483daf91f878dd8b3087",
  "name": "Finance",
  "description": "Finance-team assets",
  "config": { "colour": "var(--semantic-info-L1)" },
  "ownerId": "4274514cd27b485e8d4630dd611c01e5",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "version": "1.0"
}

config.colour (note the spelling) accepts a hex/rgb/hsl color, a CSS4 color name, or a var(--token) reference; a random theme color is assigned if omitted.

POST /tags

name is required. Returns 201 with the meta/data envelope.

PUT /tags/:tagId

Replace editable fields; returns the updated tag. 404 if the tag does not exist.

DELETE /tags/:tagId

204 No Content.