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

# Delete agent

> Permanently delete an AI agent.

# Delete agent

Permanently deletes an agent. This action can't be undone.

```http theme={null}
DELETE https://app.chatnorris.ai/api/v2/chatbots/{chatbot_id}
Authorization: Bearer <your_api_key>
```

**Required scope:** `chatbots:write`

***

## Path parameters

| Parameter | Type | Description |
| - | - | - |
| `chatbot_id` | string | ID of the agent to delete |

***

## Response `200 OK`

```json theme={null}
{
  "status": "success",
  "data": {
    "deleted": true
  }
}
```

***

> [!WARNING]
>
> Deleting an agent also deletes its knowledge base, conversation history and widget settings. This action is irreversible.

***

## Common errors

| Code | Description |
| - | - |
| `NOT_FOUND` | The agent doesn't exist or doesn't belong to your organization |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.