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:

• Authentication credentials: Your Customer ID and API Key. If you need help finding these items, go to the support article How do I find my Customer ID and API Key.

• Reference ID for the call: To delete call recordings by ID, you need the reference_id associated with the call. Follow the process for Get list of call recordings by date range to obtain this information.

• Reference page: Keep the Delete recordings by ID reference page open in another window while you work on these steps.

Steps

1. Send a DELETE https://rest-ww.telesign.com/v2/call_recording/{reference_id} request. Include the following query param values:

Request

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

2. 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"
  ]
}