Rensei docs
API ReferenceWorker Protocol

Deregister a worker

Removes the worker from the registry and releases any remaining claims. Returns the list of sessions that were unclaimed as a result. Auth: runtime JWT only (`sub` must match worker ID).

DELETE
/api/workers/{id}

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

Response Body

Worker deregistered.

application/json
  1. response
deregistered*true
Value intrue
unclaimedSessions*array<string>

Session IDs whose claims were released.

Example Request
curl -X DELETE 'https://app.rensei.ai/api/workers/string'
Example Response
{  "deregistered": true,  "unclaimedSessions": [    "string"  ]}

Get worker detail

Returns live worker state from the registry. Auth: runtime JWT (preferred, `sub` must match worker ID) or user auth (`rsk_` key / session cookie with org + project membership check).

AF-compatible worker heartbeat

Updates `activeCount` on the worker's Redis record and resets its TTL. An optional closed, redacted HarnessConnection inventory report may be submitted only with a runtime worker JWT; it contains configured connection refs plus live evidence, never host-supplied connection configuration. Registration tokens remain valid for inventory-free bootstrap heartbeats but receive a typed 403 when inventory is present. A hosted runtime supplies the exact complete D12 sessionShim projection; the platform returns that same non-secret projection only after stable-host/controller/revision/quarantine and durable receipt authority match. The optional Donmai proof-v2 readiness shape is all-or-none and echoed only; it does not independently authorize a cutover or activation. Missing, stale, or changed publication leaves the host recovering. Returns pending work queue depth.