# Request 1: Delete a campaign
curl -X DELETE "https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Delete a campaign
const response = await fetch('https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"success": true,
"message": "Campaign deleted successfully"
}
Calls & Campaigns
Delete Campaign
Permanently delete a campaign and all associated data
DELETE
/
api
/
v1
/
campaigns
/
{campaign_id}
# Request 1: Delete a campaign
curl -X DELETE "https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Delete a campaign
const response = await fetch('https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"success": true,
"message": "Campaign deleted successfully"
}
Delete Campaign
Permanently delete a campaign and all associated data including calls, files, and statistics. This action cannot be undone.Endpoint
DELETE /api/v1/campaigns/{campaign_id}
Path parameters
string
required
The unique identifier of the campaign.
Request headers
string
required
Bearer token for authentication. Format:
Bearer talq_your_environment_token_hereExample requests
# Request 1: Delete a campaign
curl -X DELETE "https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Delete a campaign
const response = await fetch('https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
# Request 2: Delete campaign with specific ID
curl -X DELETE "https://app.talkover.ai/api/v1/campaigns/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 2: Delete campaign with specific ID
const campaign_id = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(`https://app.talkover.ai/api/v1/campaigns/${campaign_id}`, {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
Response
Success Response (200 OK)
{
"success": true,
"message": "Campaign deleted successfully"
}
Response fields
boolean
required
Indicates if the operation was successful.
string
required
Success message describing the operation.
Error responses
404 Not Found
{
"success": false,
"message": "Campaign not found"
}
401 Unauthorized
{
"success": false,
"message": "Unauthorized"
}
403 Forbidden
{
"success": false,
"message": "Cannot delete active campaign"
}
409 Conflict
{
"success": false,
"message": "Campaign has active calls in progress"
}
500 Server Error
{
"success": false,
"message": "Internal server error."
}
Error codes
| Code | Description | HTTP Status |
|---|---|---|
CAMPAIGN_NOT_FOUND | Specified campaign does not exist | 404 |
INVALID_TOKEN | Authentication token is invalid or missing | 401 |
FORBIDDEN | Cannot delete campaign in current state | 403 |
CONFLICT | Campaign has active operations that prevent deletion | 409 |
SERVER_ERROR | Internal server error occurred | 500 |
Deletion rules
| Campaign Status | Can Delete | Notes |
|---|---|---|
draft | Yes | Safe to delete |
active | No | Must pause or cancel first |
paused | Yes | Safe to delete |
completed | Yes | Safe to delete |
cancelled | Yes | Safe to delete |
Important notes
Permanent deletion. This action permanently removes the campaign and all associated data. This cannot be undone.
Active campaigns. Active campaigns cannot be deleted. You must pause or cancel them first.
Associated data. Deleting a campaign also removes all associated calls, files, and statistics.
No confirmation. There is no confirmation step - the deletion happens immediately.
Related endpoints
- Get Campaign:
GET /api/v1/campaigns/{campaign_id} - Update Campaign Status:
PATCH /api/v1/campaigns/{campaign_id}/status - Create Campaign:
POST /api/v1/campaigns - Update Campaign:
PUT /api/v1/campaigns/{campaign_id} - List Campaigns:
GET /api/v1/campaigns
Was this page helpful?