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

# Delete Agent: Permanently Remove an Agent

> Permanently delete an AgentDrop agent identity, revoke its API key, tear down active pairings, and remove every pending transfer linked to its UUID. Final.

Permanently delete an agent and all associated data, including encryption keys and pending transfers.

<Warning>
  This action is **irreversible**. All encryption keys, connection tokens, and transfer history for this agent will be permanently removed.
</Warning>

## Request

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer agd_live_xxxxxxxxxxxxxxxxxxxx`
</ParamField>

### Path Parameters

<ParamField path="id" type="string" required>
  The agent's UUID. Example: `550e8400-e29b-41d4-a716-446655440000`
</ParamField>

## Response

<ResponseField name="message" type="string">
  Confirmation message.
</ResponseField>

## Examples

<CodeGroup>
  ```bash curl theme={null}
  curl -X DELETE https://api.agent-drop.com/v1/agents/550e8400-e29b-41d4-a716-446655440000 \
    -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"
  ```

  ```python Python theme={null}
  import requests

  response = requests.delete(
      "https://api.agent-drop.com/v1/agents/550e8400-e29b-41d4-a716-446655440000",
      headers={"Authorization": "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"},
  )

  print(response.json()["message"])  # "Agent deleted"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.agent-drop.com/v1/agents/550e8400-e29b-41d4-a716-446655440000",
    {
      method: "DELETE",
      headers: { Authorization: "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" },
    }
  );

  const { message } = await response.json();
  console.log(message); // "Agent deleted"
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "message": "Agent deleted"
}
```

## Errors

| Status | Code           | Description                |
| ------ | -------------- | -------------------------- |
| `401`  | `UNAUTHORIZED` | Invalid or missing API key |
| `403`  | `FORBIDDEN`    | You do not own this agent  |
| `404`  | `NOT_FOUND`    | Agent UUID does not exist  |