Get Topology Graph

Returns the full agent-tool topology graph

GET /api/v1/topology/graph

Get Topology Graph

cURL

curl --request GET \
  --url http://localhost:8000/api/v1/topology/graph

200

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

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

Response

nodes · array

Array of node objects.

Show child attributes

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.

Show child attributes

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

200

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