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

# Get Agent

> Fetch a single registered agent by id

Returns one agent from the project's registry. Use it to resolve an id you stored earlier (for
example, from [Register Agent](/api-reference/tracked-agents/add) or a monitoring signal's
`agentId`) back to its display name.

<Note>
  Agents cannot be deleted through the API - the registry row is the identity every trace,
  monitoring profile, and signal for that agent keys off. The hosted platform's
  `DELETE /ingest/tracked-agents/:botId` endpoint does not exist on the self-host engine; to
  quiet an agent, disable its monitoring profile instead
  (`PUT /api/v1/monitor/profiles/{agentId}` with `{ "enabled": false }`).
</Note>

## Authentication

<ParamField header="x-api-key" type="string" required>
  Project API key.
</ParamField>

## Path Parameters

<ParamField path="id" type="string" required>
  Agent `_id` from [List Agents](/api-reference/tracked-agents/list).
</ParamField>

## Response

<ResponseField name="agent" type="object">
  The agent: `{ "_id": string, "name": string, "createdAt": string }`.
</ResponseField>

## Errors

| Status | Body                             | Meaning                              |
| ------ | -------------------------------- | ------------------------------------ |
| `404`  | `{ "error": "Agent not found" }` | No agent with this id in the project |

<RequestExample>
  ```bash cURL theme={null}
  curl http://localhost:4700/api/v1/agents/aG5kR8sLp3WvX1nC7qZtB \
    -H "x-api-key: agtx_local_0f3c9a17d2b84e6a5c01b9f4e7d8a2c6431b5f97a0e2d4c8"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "agent": {
      "_id": "aG5kR8sLp3WvX1nC7qZtB",
      "name": "customer-support-agent",
      "createdAt": "2026-08-27T10:30:00.000Z"
    }
  }
  ```

  ```json 404 Not found theme={null}
  {
    "error": "Agent not found"
  }
  ```
</ResponseExample>