Snapshot every root session created in a window
Returns a compact projection of every live root session the caller may see that was created at or after since (at most 30 days ago), newest first, read at one instant. Rows carry only identity, agent, state, and timestamps; the response is meant to be drawn whole — one tile per session — and then kept current with streamSessionGestalt from as_of, not re-read. Served from a covering index, so its latency is a range scan of the window. Windows with more than 5000 roots are truncated to the newest 5000 and say so.
Authorizations
A Recursion API key, created in the console under API keys.
Query Parameters
Limit the snapshot to one agent in the caller workspace, before truncation.
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.
Read timestamp of this snapshot. Pass it as after to streamSessionGestalt to receive every change since.
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.
True when the window held more than 5000 root sessions and only the newest 5000 are listed.