Voice - Delete recordings

πŸ“˜

NOTE:

To add this product to your account, contact a Telesign expert. This product is available for full-service accounts only.

This page walks you step-by-step through how 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.

Before you begin

Make sure you have the following before you start:

Steps

  1. Send a DELETE https://rest-ww.telesign.com/v2/call_recording/{reference_id} request. 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
  1. Review the response. If all the files are successfully deleted, you should receive a response that looks like this:

Response

HTTP/1.1 204 No Content

Unsuccessful and partially successful deletions

You receive a 503 response if the deletion of one or more of the files associated with your specified reference ID fails. 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"
  ]
}