Skip to main content
List sessions

Authorizations

Authorization
string
header
required

Live API key minted in the dashboard. Pass as Authorization: Bearer sk_live_…. Keys are scoped to a single environment (staging / prod).

Query Parameters

status
string[] | null

Repeatable filter. Accepts a SessionStatus value or the aliases active / terminal. Multiple values OR together.

avatar_id
string | null

Filter to sessions referencing this avatar.

created_after
string<date-time> | null

Lower bound, inclusive. ISO-8601 UTC.

created_before
string<date-time> | null

Upper bound, exclusive. ISO-8601 UTC.

limit
integer
default:20

Page size. Default 20, max 100.

Required range: 1 <= x <= 100
starting_after
string | null

Pagination cursor — a sess_… id from a previous page.

Response

Successful Response

Cursor-paginated list of sessions.

data
Session · object[]
required
has_more
boolean
required
next_cursor
string | null

Pass as starting_after on the next request to continue.

object
string
default:list
Allowed value: "list"