Rensei docs
API ReferenceWorker Protocol

Worker rejection of a pre-claimed session

Allows a worker to reject a pre-claimed session (e.g. host capacity changed, workarea refused, or daemon is draining). Releases the claim and re-queues the session preserving its original priority. The original `QueuedWork` item must be supplied so the platform can re-enqueue without losing fields.

POST
/api/sessions/{id}/nack

Authorization

workerJwt
headerAuthorizationBearer <JWT>

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

Path Parameters

id*string

Request Body

application/json
  1. body
workerId*string
reason?string

Human-readable reason for rejection.

work*

The original pre-claimed QueuedWork item for this session.

Response Body

Session rejected and re-queued.

application/json
  1. response
nacked*boolean
sessionId*string
requeued*boolean
Example Request
curl -X POST 'https://app.rensei.ai/api/sessions/string/nack' \  -H 'Content-Type: application/json' \  -d '{  "workerId": "string",  "work": {    "sessionId": "string",    "issueId": "string",    "issueIdentifier": "string",    "priority": 0,    "queuedAt": 0  }}'
Example Response
{  "nacked": true,  "sessionId": "string",  "requeued": true}