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

agent_id
string

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

since
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 agent_id.

Response

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

A point-in-time snapshot of unclassified public root sessions in the requested window. Classified roots are never returned by this API.

as_of
string<date-time>
required

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

sessions
object[]
required

Every live unclassified public root session created at or after since, 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.