Skip to main content
Retrieve an agent by identifier or human-friendly name. Tenants can only read their own agents; admins can read any.

Endpoint

Authentication

Authorization: Bearer <api_key> or Authorization: ApiKey <key>. Optional if AGENT_CLOUD_API_KEY is unset.

Path parameters

string
required
Agent id (agent_<hex>) or display name.

Response

Same shape as Create Agent: id, object (agent), optional name / model / instructions / text, plus reasoning, multi_agent, service_tier, tools, and created_at (epoch ms).

Example