Skip to main content
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"

{
  "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

​
campaign
string
required
The unique identifier of the campaign.

​
Request headers

​
Authorization
string
required
Bearer token for authentication. Format: Bearer talq_your_environment_token_here

​
Example 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 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"

​
Response

​
Success Response (200 OK)

{
  "success": true,
  "message": "Campaign deleted successfully"
}

​
Response fields

​
success
boolean
required
Indicates if the operation was successful.
​
message
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

CodeDescriptionHTTP Status
CAMPAIGN_NOT_FOUNDSpecified campaign does not exist404
INVALID_TOKENAuthentication token is invalid or missing401
FORBIDDENCannot delete campaign in current state403
CONFLICTCampaign has active operations that prevent deletion409
SERVER_ERRORInternal server error occurred500

​
Deletion rules

Campaign StatusCan DeleteNotes
draftYesSafe to delete
activeNoMust pause or cancel first
pausedYesSafe to delete
completedYesSafe to delete
cancelledYesSafe 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.
  • 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