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

# Drop Call

> Use the RingQ API Web Hook to programmatically end an active call on a specific extension — useful for call supervisors and automated call management workflows.

The Drop Call web hook instructs RingQ to immediately terminate an active call on a specified extension. This is useful for supervisor controls, automated call time limits, or integrations that need to end calls from an external system.

## Prerequisites

Before you begin, you need your **API Key** from the RingQ admin dashboard.

1. Log in to the RingQ admin dashboard.
2. Go to **Settings** → **API**.
3. Copy the **API Key** shown on this page. You will use it in every web hook URL.

## API URL Format

```
https://{your-ringq-domain}/api/v2/{api-key}/dropcall/{extension}
```

| Parameter           | Description                                                                  |
| ------------------- | ---------------------------------------------------------------------------- |
| `your-ringq-domain` | The domain or IP address of your RingQ instance (e.g. `pbx.yourdomain.com`). |
| `api-key`           | Your API key from Settings → API.                                            |
| `extension`         | The extension number whose active call you want to drop.                     |

## Example

To drop the active call on extension **103**:

```
https://pbx.yourdomain.com/api/v2/abc123xyz/dropcall/103
```

RingQ will immediately hang up the active call on extension 103.

## Response

A successful request returns HTTP `200` with a JSON body:

```json theme={null}
{ "result": "success" }
```

If extension 103 has no active call, the response will return an error indicating no call was found.

<Warning>Drop Call ends the call immediately with no warning to either party. Ensure your integration only triggers this action when appropriate.</Warning>