Skip to main content
GET
/
api
/
v1
/
topology
/
graph
Get Topology Graph
curl --request GET \
  --url http://localhost:8000/api/v1/topology/graph
{
  "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"
    }
  ]
}

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.

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.
edges
array
Array of edge objects.
{
  "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"
    }
  ]
}