Recordings

A recording is a WAV file captured by <Dial record="...">, <Record> or a recorded <Conference> in your markup. You can pause, resume or stop recording on a live call, and download a finished recording with your API key. Connect does not transcribe recordings.

How recordings are made

Recording is set in the markup your webhook returns. There is no REST call that starts a recording.

• <Dial> records the conversation. Pick the mode with its record attribute (table below).
• <Record> records the caller on their own, for voicemail. It takes maxLength (default 60 seconds), finishOnKey (default #), playBeep (default false) and an action URL, then carries on to the next verb.
• <Conference> records the room with record="record-from-start".
• A number can also have a recording policy set in the dashboard. A locked policy blocks pause and stop on that number's calls.

<Response>
  <Dial record="record-from-answer"
        recordingStatusCallback="https://your.app/voice/rec-status"
        recordingStatusCallbackEvent="in-progress completed absent">
    <Number>+919876500199</Number>
  </Dial>
</Response>

Pause, resume or stop

Control recording on a live call, for example to pause while a caller reads out a card number. Send a POST with no body. Nothing is written while recording is paused.

curl -X POST https://connect.telvox.dev/api/calls/CA7Q2M9X4K1B8N3T6R0W5Y2Z9C1V4H7JL5/recording/pause \
  -H "Authorization: Bearer $TELVOX_API_KEY" \
  -H "Accept: application/json"

{
  "ok": true,
  "call_sid": "CA7Q2M9X4K1B8N3T6R0W5Y2Z9C1V4H7JL5",
  "action": "pause",
  "status": "paused",
  "session_id": null
}

Download a recording

Use the recording's name: the RecordingName in the recording callback, the last part of its RecordingUrl, or the recording_url field on a fetched call. Names use letters, digits, -, _ and .. You can only fetch your own recordings.

{
  "recording_name": "cpaas-channel-CA7Q2M9X4K1B8N3T6R0W5Y2Z9C1V4H7JL5-1719912345678",
  "call_sid": "CA7Q2M9X4K1B8N3T6R0W5Y2Z9C1V4H7JL5",
  "duration": 47,
  "mime_type": "audio/wav",
  "download_url": "https://connect.telvox.dev/api/recordings/cpaas-channel-CA7Q2M9X4K1B8N3T6R0W5Y2Z9C1V4H7JL5-1719912345678"
}

# metadata
curl https://connect.telvox.dev/api/recordings/$RECORDING_NAME/info \
  -H "Authorization: Bearer $TELVOX_API_KEY"

# audio (WAV); add ?download=1 to receive it as an attachment
curl -o call.wav https://connect.telvox.dev/api/recordings/$RECORDING_NAME \
  -H "Authorization: Bearer $TELVOX_API_KEY"

HTTP/1.1 200 OK
Content-Type: audio/wav
Content-Disposition: inline; filename="cpaas-channel-CA7Q2M9X4K1B8N3T6R0W5Y2Z9C1V4H7JL5-1719912345678.wav"
X-CPaaS-Call-Sid: CA7Q2M9X4K1B8N3T6R0W5Y2Z9C1V4H7JL5
X-CPaaS-Recording-Duration: 47

<WAV bytes>

Recording status callbacks

Set recordingStatusCallback on <Dial>, <Conference> or <Record>. Connect sends JSON with a 5 second timeout. Callbacks are not retried and not signed, so put a long random token in the URL and check it. See webhooks & callbacks.

Status values

Callback payload

{
  "RecordingStatus": "completed",
  "RecordingSource": "bridge",
  "RecordingName": "cpaas-bridge-3f6b2c1e-8d4a-4e7b-9c2f-1a5d7e9b0c4d-1719912351234",
  "RecordingUrl": "https://connect.telvox.dev/api/recordings/cpaas-bridge-3f6b2c1e-8d4a-4e7b-9c2f-1a5d7e9b0c4d-1719912351234",
  "RecordingDuration": 47,
  "RecordingCompletedAt": "2026-06-22T17:05:01.000Z",
  "CallSid": "CA7Q2M9X4K1B8N3T6R0W5Y2Z9C1V4H7JL5"
}

Fields with no value are left out. The name format depends on how the recording was made, so treat it as an opaque string.