Skip to navigation

Get a time-limited recording download URL (legacy)

View as Markdown

Legacy. Prefer GET /recordings/{callId} 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 callId does not match the expected pattern.

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.

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