> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ringg.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Terminate Calls by Campaign ID

> Stop queued and retry calls for a campaign.

Stop all active calls within a specific campaign. This terminates all queued and retry calls for the entire campaign.

<Warning>
  **Campaign Impact**: This will terminate ALL active calls in the specified campaign, affecting all contacts in that campaign.
</Warning>

<ParamField header="X-API-KEY" type="string" required>
  Your Ringg AI API key.
</ParamField>

<ParamField body="campaign_id" type="string" required>
  ID of the campaign whose calls should be terminated. Example: `0b52ca2b-7767-4cb5-ac4c-b2a4f892a856`
</ParamField>

## 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

<Info>
  **Note**: After terminating a campaign, you can restart it later if needed using the original campaign configuration.
</Info>