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

headerAuthorizationBearer <JWT>

Short-lived worker runtime JWT minted by the platform. Claims bind the worker, project, organization, registration, and scopes.

Path Parameters

id*string

Request Body

application/json
  1. body
filePaths*array<string>
Items1 <= items
reason?string
workerId?string

Response Body

Reservation result.

application/json
  1. response
reserved?array<string>
conflicts?array<>
Example Request
curl -X POST 'https://app.rensei.ai/api/sessions/string/files/reserve' \  -H 'Content-Type: application/json' \  -d '{  "filePaths": [    "string"  ]}'
Example Response
{  "reserved": [    "string"  ],  "conflicts": [    {}  ]}