Rensei docs
API ReferenceWorker Protocol

Ingest batched interview token-delta frames

Used by the interview runner to relay streamed assistant token deltas to the browser. Frames are batched (≤100ms or 20 tokens per flush) and published to `interviewTokenChannel(interviewId)` via Redis pub/sub, where `GET /api/interview/[id]/stream` picks them up for SSE re-delivery to the browser. Auth mirrors `/api/sessions/{id}/activity` (worker runtime JWT).

POST
/api/sessions/{id}/token-delta

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

Session ID (interview is resolved server-side from interviews.session_id).

Request Body

application/json
  1. body
turnId*string
frames*array<>

Response Body

Frames published to Redis pub/sub.

application/json
  1. response
published?integer

Number of frames published.

Example Request
curl -X POST 'https://app.rensei.ai/api/sessions/string/token-delta' \  -H 'Content-Type: application/json' \  -d '{  "turnId": "string",  "frames": [    {}  ]}'
Example Response
{  "published": 0}

Lightweight step-level heartbeat

Low-overhead heartbeat emitted at each agent step (tool call, turn, etc.) to signal liveness without the cost of a full status update. Updates the session's `lastToolCalledAt` timestamp in Redis. Auth failures and storage errors are swallowed (best-effort: never 5xx the caller).

Report tool execution error

Report tool execution error - Rensei REST API operation reference.