---
title: "Topology for one connection's agents"
method: GET
path: "/v1/platform/connections/{connection_id}/otel/topology"
tags: ["Platform", "Observability"]
---

# Topology for one connection's agents

`GET /v1/platform/connections/{connection_id}/otel/topology`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/platform/connections/{connection_id}/otel/topology`
- Auth: HTTP bearer

The same graph as `/v1/otel/topology`, restricted to what this connection's agents reach: the agents, the policies they hold, the vaults those grant, the chains they sign on and the systems they call. Restricted before the 500-node cap, so a large org's cap cannot cut the connection's own agents out. Walking is directed (agent → policy → vault), so a vault shared with another tenant's agent does not reveal that agent.

A `plt_` key sees one connection's agents, never the end-user's org: that org may hold agents from other platforms or the user's own. The set is agents attributed to the connection plus the ones listed on it, constrained to the connection's org. A connection that does not belong to the calling app is a 404.

## Path parameters

- `connection_id` string, uuid, required

## Response `200`

Nodes and edges reachable from the connection's agents

- OtelTopology
  - `nodes` object[], required
    - `id` string, required: Namespaced by kind, e.g. `agent:<uuid>`.
    - `kind` 'agent' | 'vault' | 'policy' | 'connector' | 'chain', required
    - `label` string, required
    - `status` 'compromised' | 'warn' | 'suspended' | 'ok': Agents only. Derived, not stored.
    - `trust` integer: Agents only. Absent until the trust engine has scored the agent.
  - `edges` object[], required
    - `from` string, required
    - `to` string, required
    - `kind` 'calls' | 'grants' | 'holds' | 'signs', required
  - `truncated` boolean, required
  - `total_nodes` integer, required: Node count before the cap.
  - `fixture` boolean: Present and true only for synthetic data.

## Other responses

- `401`: Unauthenticated
- `403`: Not a plt_ key
- `404`: Connection not found for this app

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)