Skip to main content

Hangup Call

POST 

/api/webphone/hangup/:call_identifier

End an active webphone call by removing the SIP participant from the room.

This properly terminates the phone call on both ends (webphone and phone network). When the user hangs up from the webphone UI, this endpoint should be called to ensure the SIP call is also terminated.

Args: call_identifier: Can be either:

  • call_id (e.g., "123e4567-e89b-12d3-a456-426614174000")
  • room_name (e.g., "inbound-abc123" or "phone-xyz789") This flexibility supports both outbound calls (use call_id) and inbound SIP trunk calls (use room_name) web_context: Authenticated user context phone_call_service: Phone call service

Returns: Dictionary with hangup status

Request

Responses

Successful Response