REretellai

POST /v2/take-over-live-call/{call_id}

Changed on

Take over an in-progress call from the AI agent. The agent stops responding and the specified live-listen participant is allowed to speak directly to the caller. The call must be in ONGOING status. Calls cannot be taken over while a PCI session is active.

Request

  • Base URL
    https://api.retellai.com
  • Auth
    HTTP bearer

Path parameters

call_idstring required
Example:119c3f8e47135a29e65947eeb34cf12d

The call id to take over.

Request body

participant_idstring required

The id of the live-listen participant to upgrade, obtained when joining via /v2/listen-live-call.

Example request

{
  "participant_id": "listener_a1b2c3d4e5f6g7h8i9j0"
}

Response

Call taken over successfully.

successboolean required

Example response

{
  "success": true
}

Changes