Sign in
Live

Transfer call

Transfer a SIP call to another destination. Supply a nonblank target_uri for the SIP Refer-To header.

post/live/sessions/{session_id}/refer

Path parameters

session_idstring required

Opaque Live session identifier from the creation response or incoming-call webhook. Preserve the returned value unchanged, including its prefix.

Request body

target_uristring required

URI that should appear in the SIP Refer-To header. Supports values like tel:+14155550123 or sip:agent@example.com.

Example request

{
  "target_uri": "tel:+14155550123"
}

Response

Session refer request accepted.

Changes

Changed in 2 of the 163 revisions of this API.4

  • d86203de41ae3See the full diff
    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

  • d3c0cb1ebbed1See the full diff
    • ○

      endpoint added

      endpoint-added