Calls
Transfer a live call to a human
Transfers an active in-progress call to a human phone number via Plivo. The bot announces the transfer, then Plivo bridges the caller directly to the destination number. The call’s session.completed webhook will include transfer metadata when the full call ends.
If to is omitted, the agent’s configured transfer_number is used. The agent must have transfer_enabled: true.
POST
Transfer a live call to a human
Authorizations
API key in format: rg_live_xxxx. Pass as a Bearer token in the Authorization header.
Path Parameters
The call ID.
Body
application/json
E.164 phone number to transfer to. If omitted, the agent's configured transfer_number is used.
Example:
"+919876543210"
Previous
Start a browser WebRTC sessionCreates a browser voice session and returns a room URL plus a one-time access token your browser uses to connect to the agent in real time.
The session is fully tracked on the platform — when the session ends, the same `session.completed` partner webhook fires (transcript, recording_url, extraction). The webhook payload's `call` field is omitted for these sessions because there is no associated phone call. See [Web Voice Testing](/web-voice-testing) for end-to-end browser integration code.
**Auth + limits:** Bearer API key (`rg_live_*`). Bound by the API key's concurrency limit. Rate-limited to 10 starts/minute per key.
Next
Transfer a live call to a human