Skip to main content
GET
/
v1
/
sessions
Error
A valid request URL is required to generate request examples
{
  "data": [
    {
      "session_id": "session_d8aad64dib2c7m3ae7l0",
      "name": "Standup 2026-05-23",
      "description": "Daily standup recording.",
      "created_at": "2026-05-23T09:00:00Z",
      "modified_at": "2026-05-23T09:15:00Z"
    }
  ],
  "first_id": "session_d8aad64dib2c7m3ae7l0",
  "last_id": "session_d8aad64dib2c7m3ae7l0",
  "has_more": false
}

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 sessions.

A cursor page of sessions in the focused project. The envelope matches the chats/assets list shape; page with after_id/before_id.

​
data
object[]
required
​
has_more
boolean
required

True when more sessions exist past this page.

​
first_id
string

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

​
last_id
string

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