Read the agent topology cold snapshot (nodes, edges, counters).
Returns the fleet topology snapshot for the authenticated org: session/sub-agent nodes, workflow/handoff/subagent edges, top counters (sessions / issues / today cost), and a session-activity stream seed. Optionally scoped to a project via ?project=<slug> (a slug that does not resolve in the caller org yields an empty topology, never another project's sessions). Bearer-reachable; the live delta feed is the sibling SSE stream (streamOrgSessionEvents).
Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.
In: header
Query Parameters
Scope the snapshot to this project slug.
Response Body
application/json
curl -X GET "https://example.com/api/sessions/topology"{
"nodes": [
{
"property1": null,
"property2": null
}
],
"edges": [
{
"property1": null,
"property2": null
}
],
"counters": {
"sessions": 0,
"issues": 0,
"todayCostUsd": 0
},
"streamSeed": [
{
"sessionId": "string",
"sequenceNum": 0,
"activityType": "string",
"toolName": "string",
"content": "string",
"activityTimestamp": "string"
}
]
}Subscribe to the authenticated org's live session-event SSE stream.
Subscribe to the authenticated org's live session-event SSE stream. - Rensei REST API operation reference.
Ingest a batch of iOS MetricKit telemetry payloads for the authenticated user.
Stores 1-8 raw MXMetricPayload/MXDiagnosticPayload jsonRepresentation() objects, attributed to the authenticated user. Delivery is at-least-once: redelivered payloads are deduped server-side by sha256(payload), so clients should treat a 200 as safe to clear their local spool. A credential with no user identity is rejected with 403. Crashes remain Sentry-authoritative; MXCrashDiagnostic payloads are stored as redundancy only. Rows are retained for 90 days.