Skip to main content
DELETE
/
v1
/
voice
/
campaigns
/
{campaign_id}
Delete Voice Campaign
curl --request DELETE \
  --url https://api.example.com/v1/voice/campaigns/{campaign_id} \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "message": "<string>",
  "powered_by": "<string>"
}

​
Description

Deletes a voice campaign and its associated contacts. This action cannot be undone.

​
Authentication

​
X-API-Key
string
required
Your Teli API key

​
Path Parameters

​
campaign_id
string
required
Campaign unique identifier to deleteExample: "vc 1"

​
Response Fields

​
success
boolean
Whether the deletion was successful
​
message
string
Confirmation message
​
powered_by
string
Always returns “Teli”

​
Example Request

cURL
curl -X DELETE "https://api.teli.ai/v1/voice/campaigns/vc%201" \
  -H "X-API-Key: YOUR_API_KEY"
JavaScript
const response = await fetch('https://api.teli.ai/v1/voice/campaigns/vc 1', {
  method: 'DELETE',
  headers: {
    'X-API-Key': 'YOUR_API_KEY'
  }
});

​
Example Response

200
{
  "success": true,
  "message": "Campaign vc 1 deleted",
  "powered_by": "Teli"
}
404
{
  "success": false,
  "error": "Campaign not found",
  "powered_by": "Teli"
}

​
Notes

  • Deletes campaign from DynamoDB (teli_voice_campaigns table)
  • Deletes all associated contacts from teli_voice_contacts table
  • Does NOT delete call history or recordings (those are preserved)
  • Requires exact campaign_id match
  • URL encode the campaign_id if it contains spaces (e.g., “vc 1” → “vc%201”)
  • Cannot be undone - use with caution