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

headerAuthorizationBearer <JWT>

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

Path Parameters

id*string

Worker ID (format wkr_{hex}).

Response Body

Worker detail.

application/json
  1. response
id*string

Format: wkr_{hex}

hostname*string
capacity*integer
activeCount*integer

Heartbeat-reported count (can be stale).

activeSessions?array<string>

Authoritative active session list from Redis set.

registeredAt*integer

Unix timestamp.

lastHeartbeat*integer

Unix timestamp.

status*string
Value in"active""draining""offline"
version?string
projects?array<string>
providers?array<string>
Example Request
curl -X GET 'https://app.rensei.ai/api/workers/string'
Example Response
{  "id": "string",  "hostname": "string",  "capacity": 0,  "activeCount": 0,  "activeSessions": [    "string"  ],  "registeredAt": 0,  "lastHeartbeat": 0,  "status": "active",  "version": "string",  "projects": [    "string"  ],  "providers": [    "string"  ]}

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