Calls
Terminate Call
Terminate an ongoing call.
This will hang up the call via the telephony provider (Twilio, Telnyx, or SIP). Only works for calls that are currently in ‘ongoing’ status.
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