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.

Query Parameters

agent_id
string

Limit the snapshot to one agent in the caller workspace, 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

Response body of GET /v1/sessions/gestalt: a compact snapshot of every root session an organization created in a window, read at one instant. Designed to be drawn whole -- one tile per session -- and kept current by streamSessionGestalt rather than re-read.

Response body of GET /v1/sessions/gestalt: a compact snapshot of every root session an organization created in a window, read at one instant. Designed to be drawn whole -- one tile per session -- and kept current by streamSessionGestalt rather than re-read.

as_of
string<date-time>
required

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

sessions
object[] | null
required

Every live root session created at or after since that the caller may see, newest first. Rows the caller's access policy does not permit are omitted silently.

truncated
boolean

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