Recordings - Delete recordings



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 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:


  1. Send a DELETE{reference_id} request. Include the following query param values:
reference_idA Telesign reference_id.Specifies the call for which you want to retrieve or delete recordings.yes


DELETE /v2/call_recording/D596D7B0D1800164898350B4E71B005B HTTP/1.1
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:Uak4fcLTTH/Tv8c/Q6QMwl5t4ck=

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


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": [
  "succeed_delete": [