API referenceVoice

Download a call recording

GET
/v2/calls/{id}/recording

A 5-minute signed link to the audio. A recording the caller declined does not exist. media_unavailable when file storage has no public address on this deployment, or the audio is not in file storage yet.

Authorization

ApiKey
headerAuthorizationBearer <token>

An API key from Developers → API keys: Authorization: Bearer gauge_live_… (or pulse_k_live_…).

Path Parameters

id*string

The call id.

Formatuuid

Header Parameters

Gauge-Version?string

A dated version. Default 2026-10-21.

Response Body

The recording and its signed link.

application/json
  1. response
callId*string
Formatuuid
recordingId*string
Formatuuid
durationSecs*integer|null
audio*
Example Request
curl -X GET 'https://app.gauge.chat/backend/v2/calls/497f6eca-6276-4993-bfeb-53cbbbba6f08/recording'
Example Response
{  "callId": "4722cd84-0ec7-4ef5-8c34-1b0150f45f53",  "recordingId": "bbd0b35c-32e1-4c5f-b1be-7f8fdbe015f2",  "durationSecs": 0,  "audio": {    "url": "http://example.com",    "expiresAt": "string",    "contentType": "string",    "sizeBytes": 0  }}