Skip to main content
PATCH
/
campaign
/
terminate
Terminate Calls by Campaign ID
curl --request PATCH \
  --url https://prod-api.ringg.ai/ca/api/v0/campaign/terminate \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "campaign_id": "<string>"
}
'
Stop all active calls within a specific campaign. This terminates all queued and retry calls for the entire campaign.
Campaign Impact: This will terminate ALL active calls in the specified campaign, affecting all contacts in that campaign.
​
X-API-KEY
string
required
Your Ringg AI API key.
​
campaign_id
string
required
ID of the campaign whose calls should be terminated. Example: 0b52ca2b-7767-4cb5-ac4c-b2a4f892a856

​
When to Use This

  • Campaign Issues: When a campaign has problems and needs to be stopped
  • Content Problems: If the campaign script or agent has errors
  • Budget Management: When campaign costs exceed budget
  • Schedule Changes: If campaign timing needs to be adjusted
  • Quality Control: When campaign performance is poor

​
What Gets Terminated

✅ Calls that will be terminated:
  • All calls in “registered” status (queued and waiting)
  • All calls in “retry” status (scheduled for retry)
  • Affects ALL contacts within this specific campaign
Calls from other campaigns are not affected. Calls already in progress are marked as user-terminated so follow-up retries are suppressed when the live call ends. Already completed calls are not cancelled retroactively.

​
How to Get Campaign ID

Find your campaign ID from:
  • Campaign Dashboard: Listed in your campaign management section
  • Campaign API: Use /campaign/all to list campaigns with IDs
  • Campaign Creation: Returned when you start a campaign
  • Reports: Campaign reports include the campaign ID
Note: After terminating a campaign, you can restart it later if needed using the original campaign configuration.