Create tag

View as MarkdownOpen in Claude
Creates a tag. Answers **201** with the tag document and a `Location` header pointing at the new resource. **Body** (JSON): - `name` (string, required, max 30) — unique among your organization's tags. - `color` (string, required) — hex color, e.g. `#FF5733`. New tags always append at the end of the list (`order` is assigned automatically); reposition with a follow-up `PATCH`. Requires a full-access token (read-only tokens answer 403). Validation failures answer 422 with a JSON:API `errors` document.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringRequired
colorstringRequired

Response

Successful response