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

# Terminate All Calls by Agent ID

> Terminates all active (registered/retry) calls associated with a specific agent across all campaigns.

## Terminate All Agent Calls

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>

## 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 that won't be affected:**

* Already completed calls
* Calls currently in progress (connected)
* Calls that haven't started yet

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


## OpenAPI

````yaml patch /campaign/terminate/agent
openapi: 3.0.0
info:
  title: Revenueable AI API Documentation
  description: >-
    This is the documentation for the Revenueable AI APIs. The Revenueable AI
    API follows RESTful principles, making it intuitive and easy to integrate
    with your applications. All API requests should be made to the base URL. The
    API accepts and returns data in JSON format. Ensure your requests include
    the appropriate Content-Type header for POST and PATCH requests.
  version: 2.0.0
servers:
  - url: https://prod-api.revenueable.ai/ca/api/v0
security: []
tags:
  - name: workspace
    description: Endpoints for managing your workspace.
  - name: agent
    description: Endpoints for managing assistants (agents).
  - name: calling
    description: Endpoints for making and managing calls.
  - name: campaign
    description: Endpoints for managing campaigns.
  - name: analytics
    description: Endpoints for accessing call analytics and performance metrics.
  - name: termination
    description: Endpoints for terminating active calls using different methods.
  - name: knowledgebase
    description: Endpoints for managing knowledge bases.
paths:
  /campaign/terminate/agent:
    patch:
      tags:
        - termination
      summary: Terminate All Calls by Agent ID
      description: >-
        Terminates all active (registered/retry) calls associated with a
        specific agent across all campaigns.
      operationId: terminateCallsByAgent
      parameters:
        - name: X-API-KEY
          in: header
          description: (Required) Your Revenueable AI API key.
          required: true
          schema:
            type: string
            example: 7251cb4b-3373-43a4-844c-b27a1d45e0c9
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - agent_id
              properties:
                agent_id:
                  type: string
                  description: (Required) ID of the agent whose calls should be terminated
                  example: 196d8d88-591e-4e08-8324-2f928d152fff
      responses:
        '200':
          description: Calls terminated successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Calls terminated successfully!
        '400':
          description: Bad Request - Invalid agent ID or no terminable calls found.
        '401':
          description: Unauthorized - Invalid or missing API key.

````