> ## 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 All Calls by Agent ID

> Stop queued and retry calls for a specific assistant.

Stop all active calls for a specific AI agent across all campaigns. This is useful when you need to halt all operations for a particular agent.

<Warning>
  **Impact**: This will terminate ALL active calls for the specified agent, regardless of which campaign they belong to.
</Warning>

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

<ParamField body="agent_id" type="string" required>
  ID of the agent whose calls should be terminated. Example: `196d8d88-591e-4e08-8324-2f928d152fff`
</ParamField>

## When to Use This

* **Agent Issues**: When an agent has problems and needs to stop all calls
* **Emergency Stop**: Quick way to halt all calls for a specific agent
* **Agent Maintenance**: Before updating or modifying an agent configuration
* **Resource Management**: When an agent is consuming too many resources

## What Gets Terminated

✅ **Calls that will be terminated:**

* Calls in "registered" status (queued and waiting)
* Calls in "retry" status (scheduled for retry)

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.

<Info>
  **Note**: You can find your agent ID in the agent the top of your dashboard.
</Info>