---
title: "Get Network Topology"
method: GET
path: "/v1/network/topology"
tags: ["v1", "protected", "network"]
---

# Get Network Topology

`GET /v1/network/topology`

Get the full network topology for the current workspace.

Returns all agents, skills, MCP instances, and triggers as nodes,
with edges representing their relationships.

Each entity type is fetched in its own DB session so the four queries
can run concurrently via ``asyncio.gather`` without sharing a single
async session (which is not safe for concurrent use).

## Response `200`

Successful Response

- NetworkTopologyResponse
  - `deployment_mode` string
  - `edges` NetworkEdge[], required
    - `id` string, required
    - `relation` string, required
    - `source` string, required
    - `target` string, required
  - `governance` GovernanceOverlay[], required
    - `category` string, required
    - `interceptor_name` string, required
    - `phases` string[], required
  - `nodes` NetworkNode[], required
    - `id` string, required
    - `label` string, required
    - `metadata` object
    - `status` string, nullable
    - `type` 'agent' | 'mcp_instance' | 'openapi_connection' | 'skill' | 'trigger', required

---

[API](https://skmtc.net/agentarea/apis/agentarea-api.md) · [All operations](https://skmtc.net/agentarea/apis/agentarea-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agentarea/agentarea-api/revisions/082e677c141c/schema)