Skip to main content
GET
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}$

Path Parameters

id
string
required

Label identifier.

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

Response

Label found.

Full label view returned by get and update, including display metadata.

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

CSS color (e.g. #3b82f6). Omitted when unset.

icon
string

Icon identifier. Omitted when unset.