Record calls
Stop recording a call
Stop one or all active recordings on a Vobiz call - finalize the audio file, trigger the callback URL, and make the recording available for download.
DELETE
/
api
/
v1
/
Account
/
{auth_id}
/
Call
/
{call_uuid}
/
Record
/
Stop recording a call
curl --request DELETE \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Record/ \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Record/"
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>"
}
response = requests.delete(url, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Record/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Record/
When a recording is stopped, it is finalized and made available for download. If you configured a
callback_url, it will be invoked with the recording details.Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
auth_id | string | Yes | Your Vobiz authentication ID |
call_uuid | string | Yes | Unique identifier of the call being recorded |
Request parameters
| Field | Type | Required | Description |
|---|---|---|---|
URL | string | No | The recording URL to stop. If omitted, all active recordings on the call are stopped. |
To stop only one specific recording, provide the
url returned by the Start Recording response. Omit it to stop all ongoing recordings.Example requests
curl -X DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Record/ \
-H "X-Auth-ID: YOUR_AUTH_ID" \
-H "X-Auth-Token: YOUR_AUTH_TOKEN"
{
"URL": "http://s3.amazonaws.com/recordings_2013/48dfaf60-3b2a-11e3.mp3"
}
Response
204 No Content
HTTP Status Code: 204
204 status code means the recording has been stopped and will be finalized. There is no response body.
After stopping a recording, retrieve it using the Recordings API or wait for the callback to receive the download URL.
Was this page helpful?
⌘I
Stop recording a call
curl --request DELETE \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Record/ \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Record/"
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>"
}
response = requests.delete(url, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Record/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));