Rensei docs
API ReferenceWorker Protocol

Get full recovery chain history for a session

Returns all recovery packets for the session ordered most recent first. Useful for visualizing the full crash→resume history. Auth: WorkOS session cookie (`getUser()`). Dashboard/browser only.

GET
/api/sessions/{id}/recovery-chain

Authorization

cookieAuth
wos-session<token>

WorkOS AuthKit session cookie. Required by browser-facing dashboard routes (recovery-packet, recovery-chain). Not usable from CLI or programmatic callers without an active WorkOS browser session.

In: cookie

Path Parameters

id*string

Response Body

application/json

application/json

curl -X GET "https://example.com/api/sessions/string/recovery-chain"
{
  "sessionId": "string",
  "totalPackets": 0,
  "packets": [
    {
      "id": "string",
      "tier": "string",
      "recoveryChainId": "string",
      "tokenEstimate": 0,
      "createdAt": "2019-08-24T14:15:22Z",
      "packetData": {}
    }
  ]
}
{
  "error": "Session not found"
}

Generate and store a recovery packet for a crashed session

Generates a tiered recovery packet from the provided crash context and persists it to the database. Used by the dashboard when a session enters a failed state to capture enough context for resumption. Auth: WorkOS session cookie (`getUser()`). Dashboard/browser only.

Reserve file lock for a session

Reserves the listed file paths against the session's org-scoped repo ID to prevent concurrent modification by other sessions.