REST ClientCalling

transfer

View as MarkdownOpen in Claude

Transfer an active call to a new destination. The current call leg is replaced by a new connection to the specified target.

Request

idstringRequiredformat: "uuid"
The unique identifying ID of an existing call.
paramsobjectRequired
An object of parameters that will be utilized by the active command.

Response

Call LegobjectRequired
Returned when the call is a standard PSTN, SIP, or WebRTC call.
OR
Fabric Subscriber Device LegobjectRequired

Returned when the call is a Fabric subscriber device leg. The status field is always null for this type.

Example

from signalwire.rest import RestClient
client = RestClient(
project="your-project-id",
token="your-api-token",
host="your-space.signalwire.com",
)
client.calling.transfer(
call_id="call-id-xxx",
dest={"type": "phone", "params": {"to_number": "+15559876543"}}
)