Download a call recording
download_recordingSaves a call recording audio file to disk and returns the local path; provide the recording filename from list_recordings or a call-ended webhook.
Instructions
GET /v1/recordings/download (permission recordings:read). Saves the audio file to disk and returns its local path. file is the filename field from list_recordings (or from a call.ended webhook).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file": "<file>"
},
"name": "download_recording"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | Recording filename, e.g. "2026-06/manual_11151_0612345678_..._101500.mp3" | |
| outputPath | No | Absolute path to write the file to. Defaults to VOIPSENSE_DOWNLOAD_DIR or ~/Downloads/voipsense/<basename>. |