---
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

## Changes

- **2026-04-29** `e1a530c0a2d5` — 1 warning
  - added the new `openapi_connection` enum value to the `nodes/items/type` response property for the response status `200`
- **2026-03-30** `e9c153221160` — 1 info
  - removed the `openapi_connection` enum value from the `nodes/items/type` response property for the response status `200`

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/network/topology/get.md)

---

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