Call Recording Retrieval API - Delete Recordings

This page walks you step-by-step through how to use the Call Recording Retrieval API to delete all call recordings for a specific call. You might want to do this if, for example, you accidentally recorded sensitive information during a call.

Keep the following reference page open in another window while you work on these steps:

Steps

  1. Send a DELETE /v2/call_recording/{referenceid} request to the Call Recording Retrieval API. Include the following query param values:
ParameterValueDescriptionRequired?
reference_idA TeleSign reference_id.Specifies the call for which you want to retrieve or delete recordings.yes

Request

DELETE /v2/call_recording/D596D7B0D1800164898350B4E71B005B HTTP/1.1
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:Uak4fcLTTH/Tv8c/Q6QMwl5t4ck=
Host: rest-ww.telesign.com

If all the files are successfully deleted, you should receive a response that looks like this:

Response

HTTP/1.1 204 No Content

If the deletion of one or more of the files associated with your specified reference ID fails, you receive a 503 response. The payload includes a failed_delete property, an array that lists the name of each file for which deletion failed. If there was a partial success, a succeed_delete property is also present, an array that lists the name of each file for which deletion succeeded.

HTTP/1.1 503 Service Unavailable
{
  "reference_id": "D596D7B0D1800164898350B4E71B005B",
  "failed_delete": [
    "D596D7B0D1800164898350B4E71B005B_1631039233.wav"
  ],
  "succeed_delete": [
    "D596D7B0D1800164898350B4E71B005B_1631039234.wav"
  ]
}

Did this page help you?