Skip to main content
GET
/
v1
/
assets
Error
A valid request URL is required to generate request examples
{
  "data": [
    {
      "asset_id": "asset_d8aad64dib2c7m3ae7j1",
      "status": "ready",
      "filename": "q2-launch-deck.pdf",
      "mime_type": "application/pdf",
      "size_in_bytes": 1048576,
      "created_at": "2026-05-23T10:15:30Z",
      "labels": [
        {
          "label_id": "label_d8aad64dib2c7m3ae7k0",
          "name": "q2-launches"
        }
      ]
    },
    {
      "asset_id": "asset_d8aad64dib2c7m3ae7j2",
      "status": "ready",
      "filename": "raw-notes.md",
      "mime_type": "text/markdown",
      "size_in_bytes": 4096,
      "created_at": "2026-05-23T10:16:00Z",
      "labels": []
    }
  ],
  "first_id": "asset_d8aad64dib2c7m3ae7j1",
  "last_id": "asset_d8aad64dib2c7m3ae7j2",
  "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}$

Query Parameters

after_id
string

Plain resource id from the previous response's last_id. Returns rows strictly past that id in the resource's natural sort order. Omit on the first request. Mutually exclusive with before_id.

before_id
string

Plain resource id to paginate backward from. Mutually exclusive with after_id.

limit
integer
default:25

Maximum number of items to return in this page.

Required range: 1 <= x <= 100

Response

Paginated list of assets with attached labels inline.

Cursor-paginated asset list. last_id is the next request's after_id when has_more is true.

data
object[]
required
has_more
boolean
required

True when more rows exist past this page.

first_id
string

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

last_id
string

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