PATCH /v2/update-live-call/{call_id}

Changed on

Update an ongoing call at runtime. Supports overriding dynamic variables, metadata, and the data storage setting on the running call, and controlling the live agent (inject context, trigger a response). These overrides take effect immediately on the live call; metadata and data storage setting changes are also persisted to the call record. To update a call that is no longer ongoing, use /v2/update-call/{call_id}.

Request

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

Path parameters

call_idstring required
Example:call_a4441234567890777c4a4a123e6

The call id of the ongoing call to be updated.

Request body

Example request

{
  "fields_to_override": {
    "override_dynamic_variables": {
      "additional_discount": "15%"
    },
    "metadata": {
      "customer_id": "cust_123",
      "notes": "Follow-up required"
    },
    "data_storage_setting": "everything_except_pii"
  }
}

Response

Live call updated successfully

successboolean required

Example response

{
  "success": true
}

Changes