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.
Authorization
workerJwt 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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/sessions/string/nack" \ -H "Content-Type: application/json" \ -d '{ "workerId": "string", "work": { "sessionId": "string", "issueId": "string", "issueIdentifier": "string", "priority": 0, "queuedAt": 0 } }'{
"nacked": true,
"sessionId": "string",
"requeued": true
}{
"error": "Session not found"
}{
"error": "Session not found"
}{
"error": "Session not found"
}Check file conflicts for a session
Check file conflicts for a session - Rensei REST API operation reference.
Update Linear agent session with external URLs
Posts external URLs (PR links, preview URLs, etc.) to the Linear agent session for display in the Linear UI. Sessions without a `linearSessionId` (governor-generated sessions) return `{ updated: false }` without error. Fail-closed: Linear API errors return 500.