latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

channels

Hang up a live call channel

Terminates (hangs up) a live call on the specified channel. The call is immediately disconnected for the participant identified by this channel. If the call has only two participants, the entire call ends. If the call involves multiple participants (e.g., conference or transfer), only the specified participant is disconnected.

The channelId identifies a specific participant's leg in the call. Use POST /calls/current to discover active channel IDs.

Permission: Calls Write required.

Monitoring: Required. This is a live call supervisory control. Returns 401 Unauthorized if Monitoring is OFF on your API key.

Warning: This action is immediate and irreversible — the call cannot be resumed after hangup.

post/channels/{channelId}/events/hangup

Path parameters

channelIdstring required

The unique identifier of the call channel. Use POST /calls/current to discover active channel IDs.

Response

Successfully processed — the call on the channel has been hung up.