Skip to main content
GET
List or search agent sessions

Authorizations

Authorization
string
header
required

Permanent personal API key created in the dashboard. Example: curl -H "Authorization: Bearer aty_…" https://your-host/v1/projects

Query Parameters

q
string

Optional lexical search query.

Maximum string length: 200
Example:

"Durable Objects"

limit
integer
default:20

Maximum sessions to return.

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

Opaque cursor returned by the previous page.

Maximum string length: 500

Response

The user’s agent sessions.

sessions
object[]
required
nextCursor
string | null
required