Rensei docs
API ReferenceWorker Protocol

Post completion summary

Posts a completion summary to Linear. Long summaries are split into multiple Linear comments (comment chunking).

POST
/api/sessions/{id}/completion

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

Request Body

application/json
  1. body
workerId?string
summary*string
planItems?array<>

Response Body

Summary posted.

application/json
  1. response
posted?integer

Number of comment chunks created.

errors?array<string>
Example Request
curl -X POST 'https://app.rensei.ai/api/sessions/string/completion' \  -H 'Content-Type: application/json' \  -d '{  "summary": "string"}'
Example Response
{  "posted": 0,  "errors": [    "string"  ]}

Explicitly claim a pre-queued session

Allows a worker to claim a session that was polled but not auto-claimed (e.g. after a `nack` retry). Returns the `QueuedWork` item and short-lived git credentials on success. Workers that receive `preClaimed: true` from the poll response must NOT call this endpoint.

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.