Skip to main content
GET
Stream changes to the sessions gestalt as Server-Sent Events

Authorizations

Authorization
string
header
required

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

Headers

Last-Event-ID
string<date-time>

RFC 3339 read timestamp to resume from when cursor is absent. Required one way or the other, and rejected once more than 30 days old: take a new snapshot instead.

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

The same agentId filter used for the snapshot.

createdAtGte
string<date-time>
required

RFC 3339 start of the window, the same value the snapshot was taken with.

cursor
string<date-time>

RFC 3339 read timestamp to resume from: the snapshot's asOf, or the last frame's. The Last-Event-ID header is honoured when this is absent. Required one way or the other, and rejected once more than 30 days old: take a new snapshot instead.

Response

OK

UTF-8 server-sent event wire stream. The JSON schema for each framed data value is declared by x-recursion-sse-data-schema.