Allo

Get recording download link

Returns a fresh signed link to download a call's recording, valid for 60 minutes. The link works without an Allo login: do not share it beyond the people who…

GET/v2/api/conversations/items/{id}/recording

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

CodeWhat it means
CONVERSATION_ITEM_NOT_FOUNDNo call with this ID is visible to the key's user (404).
RECORDING_NOT_FOUNDThe 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_DENIEDThe key's user cannot play this recording (403).
RECORDING_DOWNLOAD_RESTRICTEDThe line belongs to a HIPAA-enabled team (403).
RECORDING_DOWNLOAD_UNAVAILABLEThe link could not be created (500). Always retryable: true: retry in a few seconds.

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Path parameters

idstringrequired

Call ID (cll-*).

Responses

200Download link
dataobject
2 fields
urlstring

Signed link that downloads the recording, with no login.

expires_atstring<date-time>

When the link stops working, 60 minutes after the request.

400The ID has an unrecognized prefix (INVALID_ITEM_ID).
errorobject
401
403The API key lacks the CONVERSATIONS_READ scope, the key's user cannot play this recording (RECORDING_ACCESS_DENIED), or the line belongs to a HIPAA-enabled team (RECORDING_DOWNLOAD_RESTRICTED).
errorobject
404No call with this ID (CONVERSATION_ITEM_NOT_FOUND), or the item has no recording (RECORDING_NOT_FOUND). An SMS (msg-*) has no recording.
errorobject
429
500The download link could not be created (RECORDING_DOWNLOAD_UNAVAILABLE). Retry in a few seconds.
errorobject