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.

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

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."
}