Rensei docs
API ReferenceWorker Protocol

Post agent activity (thought/action/response)

Stores activity in the in-process ring buffer and forwards `thought | action | response` to the Linear AgentSession. Linear forwarding is fire-and-forget (non-fatal on failure).

POST
/api/sessions/{id}/activity

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
activity*

Response Body

Activity stored (and optionally forwarded to Linear).

application/json
  1. response
forwarded?boolean
linearSessionId?string
reason?string

Populated when forwarded is false.

Example Request
curl -X POST 'https://app.rensei.ai/api/sessions/string/activity' \  -H 'Content-Type: application/json' \  -d '{  "workerId": "string",  "activity": {    "type": "thought",    "content": "string"  }}'
Example Response
{  "forwarded": true,  "linearSessionId": "string",  "reason": "string"}