Recordings are stored by Talk and exposed in the corresponding ticket in a voice comment.

JSON Format

Recordings are represented as JSON objects with the following properties:

Name Type Read-only Mandatory Description
call_id number false true ID of a Talk call
recording_type string false false Valid types are call or voicemail

Delete Recording

  • DELETE /api/v2/channels/voice/calls/{call_id}/recordings

Allowed For

  • Admins

The id parameter should be replaced with a call ID, which you can get from the call_id property in Voice Comments.

Two recordings can be associated to the same call ID. This endpoint deletes all recordings associated with the call ID. To delete only a specific type of recording, see Delete Recording By Type.

Parameters

Name Type In Required Description
call_id integer Path true ID of a Talk call

Using curl

curl https://{subdomain}.zendesk.com/api/v2/channels/voice/calls/{call_id}/recordings.json \  -v -u {email_address}:{password} \  -X DELETE

Example Response

Status 204 No Content

Delete Recording By Type

  • DELETE /api/v2/channels/voice/calls/{call_id}/recordings/{recording_type}

Allowed For

  • Admins

The id parameter should be replaced with a call ID, which you can get from the call_id property in Voice Comments.

The recording_type is also present for Voice Comments created after January 10, 2020. For older comments, the Delete recording endpoint should be used.

Parameters

Name Type In Required Description
call_id integer Path true ID of a Talk call
recording_type string Path true Call recording type. Allowed values are "call", or "voicemail".

Using curl

curl https://{subdomain}.zendesk.com/api/v2/channels/voice/calls/{call_id}/recordings/{recording_type}.json \  -v -u {email_address}:{password} \  -X DELETE

Example Response

Status 204 No Content