Delete Agent Versions — DELETE /api/v1/delete-version

Use this endpoint to remove one or more saved agent versions that you no longer need. You can delete multiple versions in a single request by passing an array of version IDs. This is useful for cleaning up outdated snapshots and keeping your version list manageable.

Deletion is permanent. Once a version is deleted it cannot be recovered. Make sure you no longer need a version — including its instructions, chat flow, and all other configuration fields — before deleting it. The currently active version is protected and cannot be deleted; switch to a different active version first if needed.

Request

DELETE https://app.botsify.com/api/v1/delete-version Authorization: Bearer token — include your token in the Authorization: Bearer <token> header.

Body Parameters

integer[]

required

An array of one or more version IDs to delete. All specified versions must belong to a bot accessible by the authenticated token.

Example — Delete a Single Version

curl --request DELETE \
  --url "https://app.botsify.com/api/v1/delete-version" \
  --header "Authorization: Bearer <your_token>" \
  --header "Content-Type: application/json" \
  --data '{
    "version_ids": [7]
  }'

Example — Delete Multiple Versions

curl --request DELETE \
  --url "https://app.botsify.com/api/v1/delete-version" \
  --header "Authorization: Bearer <your_token>" \
  --header "Content-Type: application/json" \
  --data '{
    "version_ids": [3, 5, 7]
  }'

Response

A successful request returns 200 OK with a summary of which versions were deleted.

{
  "success": true,
  "deleted_version_ids": [3, 5, 7],
  "message": "3 version(s) successfully deleted."
}

If you attempt to delete the currently active version, the API returns a 422 Unprocessable Entity error:

{
  "success": false,
  "error": "Cannot delete the active version. Please set a different version as active before deleting."
}

Authorization

Bots & Agents

Agent Versions

Messaging

Users & Analytics

WhatsApp

Delete Agent Versions — DELETE /api/v1/delete-version

Request

Body Parameters

Example — Delete a Single Version

Example — Delete Multiple Versions

Response

​Request

​Body Parameters

​Example — Delete a Single Version

​Example — Delete Multiple Versions

​Response

Request

Body Parameters

Example — Delete a Single Version

Example — Delete Multiple Versions

Response