Download a CDN file

Proxies a Ringover CDN download (transcription, recap, audio or video) using service credentials.

Private CDN URLs cannot be opened with a public API token or in a browser. Pass the full URL in the body of this route instead.

Typical sources:

• transcription_url, recap_url, audio_url or video_url from GET /empower/call/{callUUID}
• any other Ringover CDN download URL that belongs to your team

The url must:

• use a Ringover CDN host (cdn.ringover.com, cdn-eu.ringover.com or cdn-us.ringover.com)
• be a download path (/v2/private/download/ or /v2/public/download/)
• belong to the team of the API token (the team id in the path is checked)
• point to a JSON, audio or video file (.json, .mp3, .mp4, .mpeg, .mpg, .wav, .m4a, .webm, .ogg, .mov, .aac)

Public download URLs (/v2/public/download/) are rewritten to the matching private path before the file is fetched.

The response is streamed. JSON is returned as JSON; audio and video are returned as the original binary, with the CDN Content-Type and Content-Length when present.

Permission: No specific permission required. A valid API key is sufficient. Empower Read is not required.

Monitoring: No impact. The team id in the URL must match the token's team.

curl -X POST https://public-api.ringover.com/v2/cdn/download \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://cdn.ringover.com/v2/private/download/teams/12345678/types/records/12345678-11111111/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee.mp3"}' \
  -o recording.mp3

{
  "url": "https://cdn.ringover.com/v2/private/download/teams/12345678/types/transcriptions/transcript/12345678-11111111/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee.json"
}