Skip to main content
GET
Snapshot every root session created in a window

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Query Parameters

agentId
string

Limit the snapshot to one agent in the caller's organization, before truncation.

createdAtGte
string<date-time>
required

RFC 3339 start of the window; sessions created at or after it are included. At most 30 days ago globally, or 400 days with agentId.

Response

A compact point-in-time snapshot of live unclassified public root sessions in the requested window. Classified roots are omitted.

asOf
string<date-time>
required

Read timestamp of this snapshot. Pass it as after to managedAgentsStreamSessionGestalt to receive every change since.

items
object[]
required

Every live unclassified public root session created at or after createdAtGte, newest first. Classified roots are omitted.

truncated
boolean

True when the window held more than 5000 root sessions and only the newest 5000 are listed.