Skip to main content
DELETE

Delete Campaign

Permanently delete a campaign and all associated data including calls, files, and statistics. This action cannot be undone.

Endpoint

Path parameters

string
required
The unique identifier of the campaign.

Request headers

string
required
Bearer token for authentication. Format: Bearer talq_your_environment_token_here

Example requests

Response

Success Response (200 OK)

Response fields

boolean
required
Indicates if the operation was successful.
string
required
Success message describing the operation.

Error responses

404 Not Found

401 Unauthorized

403 Forbidden

409 Conflict

500 Server Error

Error codes

Deletion rules

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