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

# Get 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).



## OpenAPI

````yaml /api-reference/openapi.json get /v1/network/topology
openapi: 3.1.0
info:
  description: >-
    Modular and extensible framework for building AI agents. This API requires
    JWT Bearer token authentication for most endpoints. Include your JWT token
    in the Authorization header. Public endpoints include /, /health, /docs,
    /redoc, and /openapi.json.
  title: AgentArea API
  version: 0.1.0
servers: []
security:
  - bearer: []
paths:
  /v1/network/topology:
    get:
      tags:
        - v1
        - protected
        - network
      summary: Get Network Topology
      description: |-
        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).
      operationId: get_network_topology_v1_network_topology_get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NetworkTopologyResponse'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    NetworkTopologyResponse:
      properties:
        deployment_mode:
          default: oss
          title: Deployment Mode
          type: string
        edges:
          items:
            $ref: '#/components/schemas/NetworkEdge'
          title: Edges
          type: array
        governance:
          items:
            $ref: '#/components/schemas/GovernanceOverlay'
          title: Governance
          type: array
        nodes:
          items:
            $ref: '#/components/schemas/NetworkNode'
          title: Nodes
          type: array
      required:
        - nodes
        - edges
        - governance
      title: NetworkTopologyResponse
      type: object
    NetworkEdge:
      properties:
        id:
          title: Id
          type: string
        relation:
          title: Relation
          type: string
        source:
          title: Source
          type: string
        target:
          title: Target
          type: string
      required:
        - id
        - source
        - target
        - relation
      title: NetworkEdge
      type: object
    GovernanceOverlay:
      properties:
        category:
          title: Category
          type: string
        interceptor_name:
          title: Interceptor Name
          type: string
        phases:
          items:
            type: string
          title: Phases
          type: array
      required:
        - interceptor_name
        - category
        - phases
      title: GovernanceOverlay
      type: object
    NetworkNode:
      properties:
        id:
          title: Id
          type: string
        label:
          title: Label
          type: string
        metadata:
          additionalProperties: true
          title: Metadata
          type: object
        status:
          anyOf:
            - type: string
            - type: 'null'
          title: Status
        type:
          enum:
            - agent
            - mcp_instance
            - openapi_connection
            - skill
            - trigger
          title: Type
          type: string
      required:
        - id
        - type
        - label
      title: NetworkNode
      type: object
  securitySchemes:
    bearer:
      bearerFormat: JWT
      description: JWT Bearer token for authentication
      scheme: bearer
      type: http
    HTTPBearer:
      scheme: bearer
      type: http

````