v45

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0114775543.6 KB
Conversations

Get a time-limited recording download URL

Returns a presigned S3 URL for the call's recording. Hand the URL straight to the customer or pull bytes server-side. The presigned URL is time-limited — typically usable for a few minutes — so don't 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.

get/conversation/{callId}/recording/download-url

Path parameters

callIdstring required
Example:CALL-1781127346211-e765f7

The callId string for the conversation (e.g. CALL-1778226705739-7e4c17). This is the callId field returned by GET /conversation, not the Mongo _id — passing _id returns 400 Invalid call ID format.

Response

Successful response — presigned URL ready to fetch.

statusboolean

Example response

{
  "status": true
}