FSM status transition
Drives the session FSM: `pending → claimed → running → finalizing → completed | failed | stopped` Terminal transitions trigger side effects: cost persistence, fleet quota accounting, Linear `agentActivityCreate`, claim release, inbox archival, issue lock release, and next-pending-work promotion.
Short-lived worker runtime JWT minted by the platform. Claims bind the worker, project, organization, registration, and scopes.
In: header
Path Parameters
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/status" \ -H "Content-Type: application/json" \ -d '{ "workerId": "string", "status": "pending" }'{
"updated": true,
"session": {
"linearSessionId": "string",
"trackerSessionId": "string",
"issueId": "string",
"issueIdentifier": "string",
"providerSessionId": "string",
"worktreePath": "string",
"status": "pending",
"createdAt": 0,
"updatedAt": 0,
"workerId": "string",
"queuedAt": 0,
"claimedAt": 0,
"priority": 0,
"promptContext": "string",
"organizationId": "string",
"workType": "research",
"agentId": "string",
"projectName": "string",
"provider": "string",
"totalCostUsd": 0,
"inputTokens": 0,
"outputTokens": 0,
"lastToolName": "string",
"lastToolCalledAt": 0,
"toolCallCount": 0
}
}{
"error": "Session not found"
}{
"error": "Session not found"
}{
"error": "Session not found"
}{
"error": "Session not found"
}Read session state
Read session state - Rensei REST API operation reference.
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).