Delete Botsify Agent — Permanently Remove by Agent ID

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.

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

string

required

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

Example

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.

{
  "id": "12345",
  "success": true,
  "message": "Agent successfully deleted."
}

Authorization

Bots & Agents

Agent Versions

Messaging

Users & Analytics

WhatsApp

Delete Botsify Agent — Permanently Remove by Agent ID

Request

Example

Response

​Request

​Example

​Response

Request

Example

Response