Rensei docs
API ReferenceSessions

Read durable execution events for one authorized session.

Returns an ascending keyset page from the durable execution ledger for exactly one session. The owning project is resolved under the authenticated organization, then intersected with machine credential fences or human project membership. To continue, JSON-encode the returned nextCursor object and pass it as cursor.

GET
/api/sessions/{id}/execution-events

Authorization

headerAuthorizationBearer <rsk_live_*>

Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.

Path Parameters

id*string

Canonical platform session id.

Length1 <= length <= 256

Query Parameters

cursor?string
Length1 <= length <= 2048
limit?integer
Range1 <= value <= 200

Response Body

One chronological page of typed durable execution events.

application/json
  1. response
ledgerVersion*string
sessionId*string
Length1 <= length <= 256
events*array<>
nextCursor?
Example Request
curl -X GET 'https://app.rensei.ai/api/sessions/string/execution-events'
Example Response
{  "ledgerVersion": "rensei.execution-ledger/v1beta1",  "sessionId": "string",  "events": [    {      "version": "rensei.execution-ledger/v1beta1",      "eventId": "string",      "orgId": "string",      "projectId": "string",      "subject": {        "kind": "session",        "id": "string",        "graphId": "string",        "sessionClass": "string"      },      "channel": "ledger",      "cursor": {        "ledgerSeq": 0,        "structuredSeq": 0,        "terminalByteOffset": 0,        "busSeq": 1      },      "eventType": "string",      "observedAt": "2019-08-24T14:15:22Z",      "recordedAt": "2019-08-24T14:15:22Z",      "persistencePolicy": "durable",      "evidence": {        "kind": "native",        "completeness": "complete",        "partial": true,        "replay": true,        "truncated": true      },      "causation": {        "rootEventId": "string",        "parentEventId": "string",        "subscriptionPath": [],        "depth": 0      },      "schema": {        "envelopeDigest": "string",        "payloadDigest": "string",        "filterCatalogueDigest": "string"      },      "payload": {        "property1": null,        "property2": null      }    }  ],  "nextCursor": {    "busSeq": 0  }}

Read a session's sent and received a2a messages.

Returns the a2a messages a dispatched session sent (metadata.senderSessionId, its handle, or the formal a2a-session owner) and received (its handle or the formal owner), newest first with cursor paging and session-wide sent/received counts. Org and project fenced like the other session reads; a cross-scope session reads as missing.

Subscribe to the authenticated org's live session-event SSE stream.

Subscribe to the authenticated org's live session-event SSE stream. - Rensei REST API operation reference.