Skip to main content
GET
Get recording download link
Required scope: CONVERSATIONS_READ
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 returns 400 INVALID_ITEM_ID.
  • url downloads the recording file with no Allo login. Anyone who has the link can download the recording until expires_at, so do not share it beyond the people allowed to hear the call.
  • expires_at is 60 minutes after the request. Call the endpoint again for a new 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

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

Call ID (cll-*).

Example:

"cll-abc123"

Response

Download link

data
object