Rensei docs
API ReferenceWorker Protocol

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.

POST
/api/sessions/{id}/files/reserve

Authorization

workerJwt
AuthorizationBearer <token>

Runtime JWT minted by the platform at worker registration. Three-segment dotted string. Claims include {jti, proj, org, sub (=workerId), reg, scope[]}. Use on all post-registration worker endpoints.

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/sessions/string/files/reserve" \  -H "Content-Type: application/json" \  -d '{    "filePaths": [      "string"    ]  }'
{
  "reserved": [
    "string"
  ],
  "conflicts": [
    {}
  ]
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}

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.

Release specific file locks

Release specific file locks - Rensei REST API operation reference.