Rensei docs
API ReferenceWorker Protocol

Get queued session detail for cloud runners

Lets a cloud runner-in-box (e2b/modal/daytona) fetch its session detail from the platform rather than the local daemon control API (`127.0.0.1:7734/api/daemon/sessions/:id`), which does not exist inside a cloud sandbox. The provisioner stamps `DONMAI_DAEMON_URL=<platform-url>` into the box's env so `donmai agent run` fetches its detail here. Source of truth is the Redis `work:items` hash. The full payload is available **only while the session is still QUEUED** - it is deleted on claim. Auth: bearer worker token (runtime JWT or legacy `WORKER_API_KEY`). The response includes `authToken`, system prompts, repo URL, and org ID - not readable without authentication.

GET
/api/daemon/sessions/{id}

Authorization

workerJwt
AuthorizationBearer <token>

Runtime JWT minted by the platform at worker registration. Three-segment dotted string. Claims include {jti, proj, org, sub (=workerId), reg, scope[]}. Use on all post-registration worker endpoints.

In: header

Path Parameters

id*string

Session ID (trackerSessionId / linearSessionId).

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/daemon/sessions/string"
{
  "sessionId": "string",
  "issueId": "string",
  "issueIdentifier": "string",
  "priority": 0,
  "queuedAt": 0,
  "prompt": "string",
  "workType": "research",
  "sourceSessionId": "string",
  "projectName": "string",
  "repository": "string",
  "kits": {},
  "platformUrl": "http://example.com",
  "organizationId": "string",
  "linearSessionId": "string",
  "providerSessionId": "string"
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}

Cancel an undelivered daemon mutation

Cancels a pending mutation before it is delivered to the daemon. Returns 409 if already delivered or terminal. Returns 404 if the mutation does not exist or does not belong to the caller's org. Once a heartbeat delivers the mutation, the only way to "undo" is to enqueue the inverse op (e.g. `project.remove` for a wrongly applied `project.add`).

List enriched sessions for the authenticated org

Returns enriched session list with health summaries. Accepts an optional project scope via `?projectId=` or `?project=<slug>`. Falls back to parsing the `Referer` header for dashboard calls.