> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracectrl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Topology Graph

> Returns the full agent-tool topology graph

Returns all agent nodes, tool nodes, and their edges. Used by the dashboard's Topology page.

### Query Parameters

**service** `string`

Filter the graph to a single service name.

### Response

**nodes** `array`

Array of node objects.

**id** `string`

Unique node identifier

**type** `string`

`agent` or `tool`

**label** `string`

Display name

**metadata** `object`

For agents: `framework`, `role`, `model`, `tools_observed`, `maturity`.
For tools: `category`.

**edges** `array`

Array of edge objects.

**id** `string`

Edge identifier

**source** `string`

Source node ID

**target** `string`

Target node ID

**type** `string`

`agent_to_agent` or `agent_to_tool`

**channel** `string`

For agent-to-agent: `function_call` or `team_member`

**observation\_count** `integer`

Times this connection was observed

**call\_count** `integer`

For tool edges: total call count

**confidence** `string`

`LOW`, `MEDIUM`, or `HIGH`

```json 200 theme={"dark"}
{
  "nodes": [
    {
      "id": "researcher-agent",
      "type": "agent",
      "label": "Researcher",
      "metadata": {
        "framework": "langchain",
        "role": "Research and analysis",
        "model": "gpt-4o",
        "tools_observed": ["search_documents", "fetch_url"],
        "maturity": "MATURE"
      }
    },
    {
      "id": "tool:search_documents",
      "type": "tool",
      "label": "search_documents",
      "metadata": {
        "category": "memory_read"
      }
    }
  ],
  "edges": [
    {
      "id": "abc123",
      "source": "researcher-agent",
      "target": "tool:search_documents",
      "type": "agent_to_tool",
      "call_count": 42,
      "tool_category": "memory_read"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.