Skip to main content
GET
/
registry
/
v1
/
agents
/
topology
Get agent topology showing agents and their subscription edges
curl --request GET \
  --url https://api.swarmd.ai/registry/v1/agents/topology \
  --header 'Authorization: Bearer <token>'
{
  "agents": [
    {
      "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "agentCardUrl": "<string>",
      "originalCardUrl": "<string>",
      "version": "<string>",
      "status": "<string>",
      "healthStatus": "<string>",
      "subscriptionCount": 123,
      "metrics": {
        "requestCount": 123,
        "errorPercentage": 123,
        "avgLatencyMs": 123
      },
      "uptimePercentage": 123,
      "tenantDetails": {
        "tenantName": "<string>",
        "publicContactEmail": "<string>"
      }
    }
  ],
  "edges": [
    {
      "sourceAgentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sinkAgentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}

Authorizations

Authorization
string
header
required

JWT token (USER, AGENT, or SERVICE auth)

Query Parameters

agentId
string<uuid>

Response

200 - */*

OK

agents
object[]
edges
object[]