Rensei docs
API ReferenceInteractive sessions

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.

POST
/api/interactive-sessions/{id}/rebind

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

The session id (agent_sessions.session_id).

Length1 <= length

Response Body

Rebound, or already active.

application/json
  1. response
sessionId*string
rebound*boolean

True only when this call actually flipped the row to active.

status*string
previousStatus*|

The status before this call, or null when already active.

Example Request
curl -X POST 'https://app.rensei.ai/api/interactive-sessions/string/rebind'
Example Response
{  "sessionId": "string",  "rebound": true,  "status": "active",  "previousStatus": "string"}

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 exact installed-restart acceptance authority for one session.

Dedicated no-store acceptance projection for the rensei-smokes tenant. Requires a human organization admin and project/session access. Returns the exact claim, latest durable fence correlations, lifecycle counters, and heartbeat quarantine rows. Local doctor equality is proved separately by the target-owned observer.