Rensei docs
API ReferenceWorker Protocol

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).

GET
/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

Worker ID (format wkr_{hex}).

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/workers/string"
{
  "id": "string",
  "hostname": "string",
  "capacity": 0,
  "activeCount": 0,
  "activeSessions": [
    "string"
  ],
  "registeredAt": 0,
  "lastHeartbeat": 0,
  "status": "active",
  "version": "string",
  "projects": [
    "string"
  ],
  "providers": [
    "string"
  ]
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}

Transfer session to another worker

Transfer session to another worker - Rensei REST API operation reference.

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).