Skip to main content
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>'
DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Record/
Stop active recordings on a call. Since a call can have multiple ongoing recordings, you can stop a specific recording by providing its URL, or stop all recordings by omitting the parameter.
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

ParameterTypeRequiredDescription
auth_idstringYesYour Vobiz authentication ID
call_uuidstringYesUnique identifier of the call being recorded

​
Request parameters

FieldTypeRequiredDescription
URLstringNoThe 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"

​
Response

204 No Content
HTTP Status Code: 204
A 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.

Authorizations

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Path Parameters

​
auth_id
string
required

Your account Auth ID

Example:

"MA_XXXXXX"

​
call_uuid
string
required

Response

204

Recording stopped