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

# Get agent

> GET /v1/agents/:id

Fetches a single agent with all its configuration.

## Request

```bash theme={null}
curl https://api.nixflex.com/v1/agents/agent_125207e452f8714a \
  -H "Authorization: Bearer KEY_ID:KEY_SECRET"
```

## Path parameters

| Parameter  | Type   | Required | Notes                               |
| ---------- | ------ | -------- | ----------------------------------- |
| `agent_id` | string | Yes      | The agent's ID (format `agent_xxx`) |

## Response

`200 OK` — returns the full agent object (same shape as [Create agent](/api-reference/agents/create)).

## Errors

| Code              | HTTP | Cause                                          |
| ----------------- | ---- | ---------------------------------------------- |
| `agent_not_found` | 404  | ID doesn't exist or belongs to another account |
