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:

{ "result": "success" }

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

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