Calls

Stream the audio of a call recording

Changed on

Streams the audio of the call recording, authenticated with the same API key as every other endpoint (no public or pre-signed link). Defaults to mp3 (audio/mpeg); ?format=wav returns audio/wav and any other value falls back to mp3. Served inline unless ?download=true, which sets Content-Disposition: attachment. Limited to 10 requests per minute. Returns 403 RECORDING_DISABLED when call recording is disabled for the workspace of the call. Returns 404 if the call does not exist, is outside the API key scope, has no recording, or its audio is no longer available.

get/v1/calls/{id}/recording/audio

Request

Path parameters

idstring uuid required

Call UUID

Query parameters

download'true' | 'false'

Set to true to receive the file as an attachment instead of inline.

format'mp3' | 'wav'

Audio format (default: mp3). Any other value falls back to mp3.

Response

Audio stream, with Content-Disposition: inline|attachment; filename="recording-<callId>.mp3|wav"

Changes