Hang up a call
/org/{tenant_code}/v2/calls/{uid}
Platform support: MT and CC
Hangs up the live call identified by uid. The uid is the same value returned by the
initiate endpoint (uid field) and the list endpoint. Scope rules match the GET endpoint:
a user token may hang up only its own extension's call; an API key / service may hang up
any call in the tenant. A uid that does not exist or is outside the caller's scope
yields 404 Not Found.
Request
Responses
- 202
- 400
- 401
- 404
- 500
- 504
Hangup request accepted
Invalid request body or missing required fields
Missing or malformed user identity
The requested resource or scope is not available. Returned, for example, when the system scope is used on a non-multi-tenant deployment, or with a non-API-key identity.
Internal server error
The proxy timed out waiting for the processing thread to service the request. For call initiation the call may still proceed on the PBX; for a list request no state is changed. The timeout only bounds how long the request is held open.