> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev.setoo.work/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get agent

> Retrieve a single agent by ID

<Callout type="warning">
  This single-agent endpoint is not independently verified against a live call in
  this documentation set — only [List agents](/docs/api-reference/agents/list-agents)
  has been confirmed. If this returns a `404`, use List agents and find your
  agent by `id` there instead.
</Callout>

Return one agent by its ID, including prompt, voice, and model configuration.

### Path parameters

<ParamField path="id" type="string" required>
  The agent ID
</ParamField>

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.agentic-os.com/api/v1/agents/AGENT_ID \
    -H "Authorization: Bearer $AGENTIC_OS_API_KEY"
  ```

  ```python Python theme={null}
  requests.get(
      "https://api.agentic-os.com/api/v1/agents/AGENT_ID",
      headers={"Authorization": f"Bearer {API_KEY}"},
  )
  ```

  ```javascript Node theme={null}
  await fetch("https://api.agentic-os.com/api/v1/agents/AGENT_ID", {
    headers: { Authorization: `Bearer ${API_KEY}` },
  });
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Support Agent",
  "agent_prompt": "You are a helpful customer support agent...",
  "llm_model_id": "gpt-4-turbo",
  "is_active": true,
  "created_at": "2026-01-15T10:30:00Z"
}
```