Conversations

Get a time-limited recording download URL

Changed on

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

Request

  • Base URL
    https://api.smallest.ai/atoms/v1
  • URL
    https://api.smallest.ai/atoms/v1/conversation/{callId}/recording/download-url
  • Auth
    HTTP bearer

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 internal document id.

Response

Successful response — presigned URL ready to fetch.

statusboolean

Example response

{
  "status": true
}

Changes