Call Commands

SIP Refer a call

Initiate a SIP Refer on a Call Control call. You can initiate a SIP Refer at any point in the duration of a call.

Expected Webhooks:

  • call.refer.started
  • call.refer.completed
  • call.refer.failed
post/calls/{call_control_id}/actions/refer

Request

  • Base URL
    https://api.telnyx.com/v2
  • URL
    https://api.telnyx.com/v2/calls/{call_control_id}/actions/refer
  • Auth
    HTTP bearer

Path parameters

call_control_idstring required

Unique identifier and token for controlling the call

Request body

sip_addressstring required

The SIP URI to which the call will be referred to.

client_statestring

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

command_idstring

Use this field to avoid execution of duplicate commands. Telnyx will ignore subsequent commands with the same command_id as one that has already been executed.

sip_auth_usernamestring

SIP Authentication username used for SIP challenges.

sip_auth_passwordstring

SIP Authentication password used for SIP challenges.

Example request

{
  "sip_address": "sip:username@sip.non-telnyx-address.com"
}

Response

Successful response upon making a call control command.

Example response

{
  "data": {
    "result": "ok"
  }
}

Changes

No recorded changes to this operation across all 89 revisions of this API.