Sign in
latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

channels

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.

post/channels/{channelId}/events/transfer

Path parameters

channelIdstring required

The unique identifier of the call channel. Use POST /calls/current to discover active channel IDs.

Request body

phone_numberinteger

Example request

{
  "phone_number": 33123456789
}

Response

Successfully processed — the call transfer has been initiated.