Rensei docs
API ReferenceWorker Protocol

Post milestone progress message

Post milestone progress message - Rensei REST API operation reference.

POST
/api/sessions/{id}/progress

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
milestone?string

Named milestone (e.g. claimed, worktree, started, running, tests, pr, completed, failed).

message?string

Progress message (forwarded to the activity buffer and Linear). Required except on beacon-only posts (beaconStep present), which write the beacon and skip both lanes.

beaconStep?string

Status-beacon step text (the agent's own words, e.g. 'editing the sampler ISR'). Merged into the session metadata; the execution-shell descriptor prefers it over the derived clause. Optional — old runners omit it.

beaconAt?string

ISO-8601 instant the beacon step was stamped. Defaults to receipt time when omitted. Optional — old runners omit it.

Response Body

Progress stored.

application/json
  1. response
stored?boolean
Example Request
curl -X POST 'https://app.rensei.ai/api/sessions/string/progress' \  -H 'Content-Type: application/json' \  -d '{  "workerId": "string"}'
Example Response
{  "stored": true}