List agents

GET

/api/v2/agents

The workspace's agents. The AI Builder's own are not listed, and chat never runs them.

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/v2/agents" \  -H "Authorization: Bearer sk-syn-..."

[  {    "id": "agent_01a10b7e2c4d6f8a0b1c3d5e7f9a2b4c",    "name": "Order desk",    "updated_at": "2026-10-03T09:10:05Z"  }]