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

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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. You can find this in your dashboard under Campaigns.

​
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
draft✅ YesSafe to delete
active❌ NoMust pause or cancel first
paused✅ YesSafe to delete
completed✅ YesSafe to delete
cancelled✅ YesSafe 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.

​
Best Practices

  1. Check status first - Verify campaign status before attempting deletion
  2. Backup important data - Export any important campaign data before deletion
  3. Stop active campaigns - Pause or cancel active campaigns before deletion
  4. Handle errors - Implement proper error handling for deletion failures
  5. Confirm intent - Add confirmation steps in your application before calling this endpoint
  • 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