Skip to main content
POST
Immediately terminate an ongoing call. This endpoint allows you to programmatically hang up a call that is currently in progress. This endpoint requires an authenticated, verified user account.

Use Cases

  • Admin intervention: Manually end calls that need immediate termination
  • Automatic cutoff: End calls when certain conditions are met (e.g., time limits, budget caps)
  • Emergency stop: Quickly terminate all active calls during system maintenance
  • Quality control: End calls that are not meeting quality standards

Path Parameters

Request

This endpoint does not require a request body.

Response

Success (200 OK)

Error Responses

400 Bad Request

Returned when the call is not in an “ongoing” status.

404 Not Found

Returned when the call doesn’t exist or doesn’t belong to your organization.

500 Internal Server Error

Returned when the telephony provider fails to terminate the call.

Provider Support

This endpoint works with all supported telephony providers: The system automatically detects which provider to use based on the call’s metadata.

Examples

Python

Node.js

Terminate All Active Calls

Notes

  • The call status will be updated to “completed” in the database after termination
  • Call duration is calculated up to the termination time
  • Billing is recorded for the portion of the call that occurred
  • Termination is immediate - there is no graceful hangup message by default

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

call_sid
string
required

Response

Successful Response