Get a time-limited recording download URL (legacy)

View as Markdown
**Legacy.** Prefer [`GET /recordings/{callId}`](#get-a-presigned-recording-download-url) for new integrations. It supports both mono and dual channels via `?channel=mono|dual` and uses the same authenticated flow. Returns a presigned S3 URL for the call's mono composite recording. Hand the URL straight to the customer or pull bytes server-side. The presigned URL is time-limited to 15 minutes (same TTL as the new endpoint); do not cache it, request a fresh one each time you need the recording. Returns `404` if the call has no recording (call hasn't started, was cancelled before audio captured, or was deleted by the platform's retention policy). Returns `400 Invalid call ID format` if you pass a Mongo `_id` instead of the `callId` string.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

callIdstringRequiredformat: "^CALL-\d{13}-[a-fA-F0-9]{6}$"

The callId string for the conversation (e.g. CALL-1778226705739-7e4c17). This is the callId field returned by GET /conversation, not the internal document id.

Response

Successful response — presigned URL ready to fetch.

statusbooleanOptional
dataobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
500
Internal Server Error