Returns a fresh link that downloads a call's recording, valid for 60 minutes. Use it when the recording_download_url you received has expired, or when you need a link on demand. The endpoint works on every account, not only on accounts created by a partner.
{id}is a call ID (cll-*). An ID with an unrecognized prefix returns400 INVALID_ITEM_ID.urldownloads the recording file with no Allo login. Anyone who has the link can download the recording untilexpires_at, so do not share it beyond the people allowed to hear the call.expires_atis 60 minutes after the request. Call the endpoint again for a new link.
Who can get the link
The user of the API key must be able to play the recording in Allo: the line owner, a team admin or manager, a member the line is shared with, or the recipient of a summary share. Anyone else gets 403 RECORDING_ACCESS_DENIED.
Allo never creates a download link for a call on a HIPAA-enabled team. Those calls return 403 RECORDING_DOWNLOAD_RESTRICTED: listen to the recording in the Allo app instead.
Errors
| Code | What it means |
|---|---|
CONVERSATION_ITEM_NOT_FOUND | No call with this ID is visible to the key's user (404). |
RECORDING_NOT_FOUND | The call has no recording, or the ID is an SMS (msg-*) (404). Only answered calls on lines with call recording on have one. |
RECORDING_ACCESS_DENIED | The key's user cannot play this recording (403). |
RECORDING_DOWNLOAD_RESTRICTED | The line belongs to a HIPAA-enabled team (403). |
RECORDING_DOWNLOAD_UNAVAILABLE | The link could not be created (500). Always retryable: true: retry in a few seconds. |