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

AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

curl -X DELETE "https://example.com/api/workers/string"
{
  "deregistered": true,
  "unclaimedSessions": [
    "string"
  ]
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}

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. Returns pending work queue depth.