Rensei docs
API ReferenceInteractive sessions

Get durable A2A and host-heartbeat context for a live session.

A no-store pull snapshot for the collapsible live-session rail. Authentication accepts a browser session or WorkOS user token only. Returns 404 for absent, wrong-org, or inaccessible sessions so existence is not leaked. A2A messages come from the durable inbox; host telemetry comes from heartbeat rows; assignment exposes only closed state facts, never cloud/local provenance or ownership identity; continuity exposes only bounded adoption revisions, ordering timestamps, proof counts, release posture, lifecycle counters, and the newest live carrier handoff's non-secret credential facts (token-jti DIGEST, expiry, handoff revision). Raw worker, host, tenant, session, credential, timestamp, opaque-receipt, and cross-tenant identifiers are never included in assignment.

GET
/api/interactive-sessions/{id}/live-context

Authorization

headerAuthorizationBearer <WorkOS user access token>

WorkOS user access token created by the Rensei CLI. The authenticated organization is resolved from membership and may be narrowed with X-Rensei-Org.

Path Parameters

id*string

The session id (agent_sessions.session_id).

Length1 <= length

Response Body

Current live rail context.

application/json
  1. response
refreshedAt*string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
identity*|null
messages*array<>
Itemsitems <= 5
host*|
assignment*
continuity*|
Example Request
curl -X GET 'https://app.rensei.ai/api/interactive-sessions/string/live-context'
Example Response
{  "refreshedAt": "2019-08-24T14:15:22Z",  "identity": {    "handle": "string",    "displayName": "string",    "role": "string",    "addressable": true  },  "messages": [    {      "seq": 1,      "senderId": "string",      "status": "string",      "text": "string",      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "host": {    "available": true,    "id": "string",    "displayName": "string",    "daemonVersion": "string",    "cpuCores": 0,    "cpuModel": "string",    "memTotalMb": 0,    "lastCpuPct": 0,    "lastMemPct": 0,    "sessionLoad": {      "active": 0,      "max": 0    },    "loadAverage": {      "one": 0,      "five": 0,      "fifteen": 0    },    "daemonStartedAt": "2019-08-24T14:15:22Z",    "reportedUptimeSec": 0,    "lastHeartbeat": "2019-08-24T14:15:22Z",    "health": "online",    "freshUntil": "2019-08-24T14:15:22Z",    "offlineAt": "2019-08-24T14:15:22Z"  },  "assignment": {    "redisState": "absent",    "sqlWorkerProjection": "absent",    "lastReset": "none"  },  "continuity": {    "available": true,    "enabled": true,    "adoptionRevision": "string",    "reportedAdoptionRevision": "string",    "adoptionComplete": true,    "adoptionCommittedAt": "2019-08-24T14:15:22Z",    "readyAt": "2019-08-24T14:15:22Z",    "snapshotReceipts": {      "verifiedForReady": true,      "stored": 0,      "consumed": 0,      "abandoned": 0    },    "correlations": {      "total": 0,      "adopted": 0,      "terminal": 0,      "unresolved": 0,      "held": 0,      "expiredUnreconciled": 0,      "duplicateFenceCorrelations": 0    },    "recoveryObligations": {      "total": 0,      "active": 0,      "resolved": 0,      "preparing": 0,      "adopted": 0,      "quarantined": 0    },    "release": {      "permitted": true,      "basis": "no_restart_fence",      "refusal": "restart_fence_held"    },    "lifecycleCounters": {      "completedReleaseMutations": 0,      "completedRequeueMutations": 0,      "activeOrAmbiguousMutations": 0,      "duplicateAuthoritativeRows": 0    },    "carrierCredential": {      "tokenJtiDigest": "string",      "expiresAt": "2019-08-24T14:15:22Z",      "handoffRevision": "string"    }  }}

Get one interactive session's detail.

Authentication accepts a browser session or a WorkOS user token only; an rsk API key or a BYOA OAuth-agent token is rejected 403 (no user identity to derive driver/viewer capability from). Returns 404 - never 403 - for a session belonging to a different org or one the caller has no project access/grant for, so existence is never leaked across the boundary.

Re-bind a paused-but-alive interactive session back to active.

Manual counterpart to the relay host_connected CAS: flips a paused/unknown row back to active on evidence other than a live relay handshake (the caller - rensei session rebind - has already verified the local session-shim registry record and harness pid are alive). Idempotent: rebinding an already-active session returns rebound:false with status active and no write. Refuses (409) a terminal row (ended/failed) or one with recorded terminal evidence for this session's shim lineage - a resolved recovery obligation, OR a restart-fence-linked terminal observation, whichever exists - never resurrects either. Single-session granularity only.