Calls

Get recording download URL

Generate a temporary signed URL to download a call's audio recording. The returned URL is valid for 15 minutes and points directly to the recording file. Returns 404 if the call does not exist in your project or has no recording (for example, a call that never connected). Use this instead of reading the recording_file field on the call record, which is an internal reference and not directly downloadable.

GET

https://api.nabrah.ai/api/ext/call/get-download-link/{call_id}

curl --request GET \
  --url 'https://api.nabrah.ai/api/ext/call/get-download-link/<call_id>' \
  --header 'X-API-Key: <your-api-key>'

{
  "url": "string"
}

Response

url

A signed, time-limited download link for the recording. Fetch or stream it within 15 minutes; after expiry, call this endpoint again to mint a fresh URL.

url

Where the call_id comes from

Search or make-call

Use calls[].id from POST /api/ext/call/search, or a value from call_ids[] returned by POST /api/ext/call/make-call.

Recordings only exist for calls that produced audio; expect a 404 for queued, ringing, or failed-to-connect calls.

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Path parameters

call_idstringrequired

UUID of the call whose recording you want to download.

Obtain from POST /api/ext/call/search (calls[].id) or the call_ids[] of a make-call response. Must belong to the API key's project and have a recording.

Response

200

Successful Response

application/json

422

Validation Error

application/json