Rensei docs

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).

GET
/api/sessions/topology

Authorization

AuthorizationBearer <token>

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

project?string

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"
    }
  ]
}
Empty
Empty