> ## 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 Specific Calls by Call IDs

> Terminates specific calls using their unique call IDs. Useful when you know exactly which calls to stop.

## Terminate Specific Calls

Stop individual calls by providing their unique call IDs. This gives you precise control over which calls to terminate.

<Warning>
  **Precision Required**: Make sure you have the correct call IDs. Invalid IDs will be ignored.
</Warning>

## When to Use This

* **Selective Termination**: Stop only specific problematic calls
* **Quality Control**: Terminate calls that aren't performing well
* **Customer Requests**: Stop calls to specific contacts who requested removal
* **Targeted Control**: Fine-grained call management

## How to Get Call IDs

You can find call IDs from:

* **Call History API**: Use the [Get Call History](/api-reference/endpoint/history/get-call-history) endpoint
* **Real-time Monitoring**: Dashboard call monitoring section
* **Webhook Notifications**: Call status updates include call IDs
* **Campaign Reports**: Export campaign data to get call IDs

## Request Format

Send an array of call IDs to terminate:

```json theme={null}
{
  "call_ids": [
    "86815974-8a87-4e32-9953-aca4f97868ab",
    "9ab99d2d-595c-4ca1-bab7-07d13f253156"
  ]
}
```

<Info>
  **Tip**: You can terminate up to 100 calls in a single request for efficient bulk operations.
</Info>


## OpenAPI

````yaml patch /campaign/terminate/calls
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/calls:
    patch:
      tags:
        - termination
      summary: Terminate Specific Calls by Call IDs
      description: >-
        Terminates specific calls using their unique call IDs. Useful when you
        know exactly which calls to stop.
      operationId: terminateCallsByIds
      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:
                - call_ids
              properties:
                call_ids:
                  type: array
                  items:
                    type: string
                  description: (Required) Array of call IDs to terminate
                  example:
                    - 86815974-8a87-4e32-9953-aca4f97868ab
                    - 9ab99d2d-595c-4ca1-bab7-07d13f253156
      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 call IDs or no terminable calls found.
        '401':
          description: Unauthorized - Invalid or missing API key.

````