Skip to main content
GET
/
v1
/
labels
Error
A valid request URL is required to generate request examples
{
  "data": [
    {
      "label_id": "label_d8aad64dib2c7m3ae7k0",
      "name": "q2-launches"
    },
    {
      "label_id": "label_d8aad64dib2c7m3ae7k1",
      "name": "research"
    }
  ],
  "first_id": "label_d8aad64dib2c7m3ae7k0",
  "last_id": "label_d8aad64dib2c7m3ae7k1",
  "has_more": false
}

Documentation Index

Fetch the complete documentation index at: https://dev.chief.bot/llms.txt

Use this file to discover all available pages before exploring further.

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}$

Response

All labels in the project.

Labels visible in the focused project. The per-project label cap bounds the list, so has_more is always false today — the envelope matches the chats/assets list shape so clients can normalize.

​
data
object[]
required
​
has_more
boolean
required

Always false for labels in v1.

​
first_id
string

Id of the first label in this page; omitted when empty.

​
last_id
string

Id of the last label in this page; omitted when empty.