Skip to main content

Bridge calls

POST 
/calls/:call_control_id/actions/bridge

Bridge two call control calls.

Expected Webhooks:

  • call.bridged for Leg A
  • call.bridged for Leg B

Request

Path Parameters

    call_control_id stringrequired

    Unique identifier and token for controlling the call

Body

required

Bridge call request

    call_control_id stringrequired

    The Call Control ID of the call you want to bridge with, can't be used together with queue parameter or video_room_id parameter.

    client_state string

    Use this field to add state to every subsequent webhook. It must be a valid Base-64 encoded string.

    command_id string

    Use this field to avoid duplicate commands. Telnyx will ignore any command with the same command_id for the same call_control_id.

    queue string

    The name of the queue you want to bridge with, can't be used together with call_control_id parameter or video_room_id parameter. Bridging with a queue means bridging with the first call in the queue. The call will always be removed from the queue regardless of whether bridging succeeds. Returns an error when the queue is empty.

    video_room_id uuid

    The ID of the video room you want to bridge with, can't be used together with call_control_id parameter or queue parameter.

    video_room_context string

    The additional parameter that will be passed to the video conference. It is a text field and the user can decide how to use it. For example, you can set the participant name or pass JSON text. It can be used only with video_room_id parameter.

    park_after_unbridge string

    Specifies behavior after the bridge ends (i.e. the opposite leg either hangs up or is transferred). If supplied with the value self, the current leg will be parked after unbridge. If not set, the default behavior is to hang up the leg.

    play_ringtone boolean

    Specifies whether to play a ringtone if the call you want to bridge with has not yet been answered.

Responses

200: Successful response upon making a call control command.

default: Unexpected error

Callbacks

Loading...