Skip to main content
POST
Transfer Active Call

Overview

Transfers an active call to a different phone number while the call is in progress. The current call leg is replaced with a <Dial> to the new number, no announcement is played to either party. Only calls in queue_status: "started" are eligible. Once transferred, the call record’s transferred_to field is updated so the new number appears in call details.

Headers

string
required
Your API key for authentication.

Body Parameters

string
required
ID of the active call to transfer. Must currently be in progress.
string
required
Destination phone number in E.164 format (for example +12223334444). Parsed against the US region by default, so 10-digit US numbers also work.

Response

string
Confirmation message including the call_id and the destination number.
null | array
null on success.

Docs for agents: llms.txt