Rensei docs
API ReferenceSessions ( Public)

Real-time fleet statistics (org-scoped)

Returns live worker fleet and session queue metrics for the active org. Requires a session cookie or `rsk_` API key - despite the `/api/public` prefix, this endpoint is not anonymous.

GET
/api/public/stats

Authorization

headerAuthorizationBearer <rsk_live_*>

Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.

Response Body

Fleet stats.

application/json
  1. response
workersOnline*integer
agentsWorking*integer
queueDepth*integer
completedToday*integer
availableCapacity*integer
totalCostToday*number
totalCostAllTime*number
sessionCountToday*integer
timestamp*string
Formatdate-time
Example Request
curl -X GET 'https://app.rensei.ai/api/public/stats'
Example Response200
{  "workersOnline": 0,  "agentsWorking": 0,  "queueDepth": 0,  "completedToday": 0,  "availableCapacity": 0,  "totalCostToday": 0,  "totalCostAllTime": 0,  "sessionCountToday": 0,  "timestamp": "2019-08-24T14:15:22Z"}

Stop a running session

Sends a stop signal to the session: flips Redis status to `stopped`, releases queue/claim/lock, and emits a "Stop signal received" activity to the tracker. A session live on an ADOPTED session-shim lineage (its host daemon restarted and re-owned the harness) cannot be terminalized by the caller: the common release predicate holds its claim until that lineage's own terminal proof arrives. For that case the stop is DELIVERED (relay kill toward the active carrier plus the cooperative Redis rail) and the route answers 202 with `stopped:false, delivered:true, pending:"terminal_evidence"`; the session goes terminal when the daemon posts the group-reaped tombstone. 409 is reserved for a hold nothing can be delivered through (a quarantined or still-preparing lineage, or a restart hold window): retry.

Read org security metrics (overview / health / timeline / posture).

Returns security dashboard metrics scoped to the authenticated org. `metricType` selects the projection: overview (all sections), health, timeline, or posture. `timeRange` ∈ 24h/7d/30d/90d. Bearer-reachable for human principals (user token or browser session); rsk_* API keys and BYOA OAuth-agent tokens are rejected 403.