Delete Campaign

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

DELETE

api

campaigns

{campaign_id}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Permanently delete a campaign and all associated data including contacts, executions, and schedules.

Running campaigns cannot be deleted. Stop the campaign first using the stop endpoint.

This action is irreversible. All campaign data, contacts, and execution history will be permanently deleted.

Path Parameters

campaign_id (integer, required): The unique identifier of the campaign

Response

{
  "message": "Campaign deleted successfully"
}

What Gets Deleted

When you delete a campaign, the following data is permanently removed:

Campaign configuration and settings
All imported contacts
Execution history and logs
Schedule configurations
Import history records

Example Code

cURL

curl -X DELETE "https://api.burki.dev/api/v1/campaigns/42" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import requests

response = requests.delete(
    "https://api.burki.dev/api/v1/campaigns/42",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

if response.status_code == 200:
    print("Campaign deleted successfully")
else:
    print(f"Error: {response.json()}")

JavaScript

const response = await fetch("https://api.burki.dev/api/v1/campaigns/42", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
});

if (response.ok) {
  console.log("Campaign deleted successfully");
} else {
  const error = await response.json();
  console.error("Error:", error);
}

Error Responses

Status Code	Description
400	Cannot delete running campaign - stop it first
404	Campaign not found
401	Unauthorized - invalid or missing API key

Best Practices

Export data first if you need to keep records of the campaign results
Stop running campaigns before attempting to delete
Consider pausing instead of deleting if you might need the campaign later

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

campaign_id

integer

required

Response

Successful Response

API Documentation

Assistants

Assistant Phone Numbers

Assistant Documents (RAG)

Voice Cloning

Calls

Messaging

SIP Trunks

Billing

Phone Number Management

Call Data

Organization

Webhooks & System

Campaigns

WebSockets

Tools & Custom Actions

Conversation Flows

Learning & Memory

Path Parameters

Response

What Gets Deleted

Example Code

Error Responses

Best Practices

Authorizations

Path Parameters

Response

​Path Parameters

​Response

​What Gets Deleted

​Example Code

​Error Responses

​Best Practices

Authorizations

Path Parameters

Response

Path Parameters

Response

What Gets Deleted

Example Code

Error Responses

Best Practices