Get a time-limited recording download URL

GET

https://api.smallest.ai/atoms/v1/conversation/:callId/recording/download-url

GET

/atoms/v1/conversation/:callId/recording/download-url

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/conversation/CALL-1781127346211-e765f7/recording/download-url"
4 
5 payload = {}
6 headers = {
7     "Authorization": "Bearer <token>",
8     "Content-Type": "application/json"
9 }
10 
11 response = requests.get(url, json=payload, headers=headers)
12 
13 print(response.json())

1 {
2   "status": true,
3   "data": {
4     "presignedUrl": "https://s3.amazonaws.com/recordings/call-1781127346211-e765f7/audio-20240601-153000.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20240601%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20240601T153000Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
5   }
6 }

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.

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.

Authentication

AuthorizationBearer

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

Path parameters

callIdstringRequired

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

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error