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

AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/sessions/string/completion" \  -H "Content-Type: application/json" \  -d '{    "summary": "string"  }'
{
  "posted": 0,
  "errors": [
    "string"
  ]
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}

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.