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

# Delete Botsify Agent — Permanently Remove by Agent ID

> Permanently delete a Botsify agent by its ID. All associated data, including conversation history, flows, and settings, is removed and cannot be recovered.

Permanently remove an agent from your Botsify workspace by its ID. Once deleted, the agent's configuration, conversation history, flows, and associated data are irrecoverably removed. Make sure you have exported or backed up anything you need before calling this endpoint.

> [!WARNING]
>
> Deleting an agent is **permanent and irreversible**. All associated data — including conversation history, flows, integrations, and settings — will be removed immediately and cannot be recovered. Double-check the agent ID before making this request.

## Request

**id** `string` *required*

The unique ID of the agent to delete. This is supplied as a path parameter in the URL.

## Example

```bash theme={null}
curl --request DELETE \
  --url https://app.botsify.com/api/v1/delete-agent/12345 \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

## Response

A successful `200 OK` response confirms the agent has been permanently deleted.

| Field | Type | Description |
| - | - | - |
| `id` | string | The ID of the agent that was deleted. |
| `success` | boolean | `true` when the agent was successfully deleted. |
| `message` | string | A human-readable confirmation message. |

```json theme={null}
{
  "id": "12345",
  "success": true,
  "message": "Agent successfully deleted."
}
```


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