Skip to main content
GET
sessions.list({ agentId?, metadata?, createdAfter?, createdBefore? })

Authorizations

Authorization
string
header
required

An API key, or a session token on its own session

Query Parameters

agentId
string

Only the sessions of this agent

metadata
object

Matches every listed key exactly: metadata[teamId]=t_42 The customer's own string keys and values; never case-converted.

createdAfter
string<date-time>

Only sessions created at or after this time (RFC 3339)

createdBefore
string<date-time>

Only sessions created before this time (RFC 3339)

limit
integer
default:50

Page size

Required range: 1 <= x <= 200
cursor
string

The nextCursor of the previous page

Response

A page of sessions

Every resource list returns one page: a cursor-paged slice of items. Typed pages extend it.

data
object[]
required
nextCursor
string | null
required