List agents

GET

/api/v1/agents

The workspace's agents. The AI Builder's own are not listed, and the chat endpoints never run them. model is empty when the agent uses the default model; capabilities is always an empty list.

Authorization

apiKey

headerAuthorizationBearer <token>

An API key, sk-syn- and 32 characters. On SynapseOrch Cloud an owner or admin makes it under Settings → Developer; on a self-hosted install, under Settings → API Keys.

Response Body

The agents.

application/json

response

[index: integer]?

curl -X GET "https://api.synapseorch.com/api/v1/agents" \  -H "Authorization: Bearer sk-syn-..."

[  {    "id": "agent_1726412345678",    "name": "Research Agent",    "type": "conversational",    "model": "claude-opus-5",    "capabilities": []  }]