Skip to main content
POST
Error

Authorizations

X-API-Key
string
header
required

Personal Access Token, sent verbatim as pat_<32 chars>. PATs are minted from the Chief settings UI.

Headers

X-Project-Id
string
required

Project identifier scoping the request. Required on every project-scoped public endpoint. Missing or malformed values respond with HTTP 400 and code publicapi.tenancy.project.missing.

Pattern: ^project_[a-z0-9]{20}$

Body

application/json
name
string
required

Display name for the label.

Required string length: 2 - 255
color
string

Optional CSS color (e.g. #3b82f6).

icon
string

Optional icon identifier.

Response

Label created.

label_id
string
required
Pattern: ^label_[a-z0-9]{20}$
name
string
required