Get an agent

GET

/api/v1/agents/{agent_id}

One agent's summary and description. An agent that is not in the workspace, or one of the AI Builder's own, is a 404.

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.

Path Parameters

agent_id*string

The agent's id.

Response Body

The agent.

application/json

response

id?string

name?string

type?string

model?string

capabilities?array<unknown>

description?string

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

{  "id": "agent_1726412345678",  "name": "Research Agent",  "type": "conversational",  "model": "claude-opus-5",  "capabilities": [],  "description": "Deep research using web browsing"}