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

> Terminates all active (registered/retry) calls within a specific campaign.

## Terminate Campaign Calls

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>

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

* Calls from other campaigns
* Already completed calls in this campaign
* Calls currently in progress (connected)

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

## Use Cases

### Emergency Stop

Quickly halt a problematic campaign:

```bash theme={null}
# Stop campaign immediately
curl -X PATCH /campaign/terminate/campaign \
  -H "Content-Type: application/json" \
  -d '{"campaign_id": "0b52ca2b-7767-4cb5-ac4c-b2a4f892a856"}'
```

### Budget Control

Stop campaigns that exceed budget limits before more calls are made.

### Quality Issues

Halt campaigns with script problems or poor performance metrics.


## OpenAPI

````yaml patch /campaign/terminate/campaign
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/campaign:
    patch:
      tags:
        - termination
      summary: Terminate All Calls in Campaign
      description: >-
        Terminates all active (registered/retry) calls within a specific
        campaign.
      operationId: terminateCallsByCampaign
      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:
                - campaign_id
              properties:
                campaign_id:
                  type: string
                  description: >-
                    (Required) ID of the campaign whose calls should be
                    terminated
                  example: 0b52ca2b-7767-4cb5-ac4c-b2a4f892a856
      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 campaign ID or no terminable calls found.
        '401':
          description: Unauthorized - Invalid or missing API key.

````