Transfer a live call to another number or user
Transfers the live call on the specified channel to another phone number or user. The current participant is disconnected and the call is redirected to the transfer destination. This is a blind (cold) transfer — the call is forwarded immediately without announcing the transfer to the destination.
The channelId identifies a specific participant's leg in the call. Use POST /calls/current to discover active channel IDs. The transfer destination is specified in the request body.
Permission: Calls Write required.
Monitoring: Required. This is a live call supervisory control. Returns 401 Unauthorized if Monitoring is OFF on your API key.
Path parameters
The unique identifier of the call channel. Use POST /calls/current to discover active channel IDs.
Request body
Example request
{
"phone_number": 33123456789
}Response
Successfully processed — the call transfer has been initiated.
Changes
No recorded changes to this endpoint across all 3 revisions of this API.