Vobiz Logo
Console ↗
← Back to Record Calls

Stop Recording a Call

Stop an active recording on a call, optionally specifying which recording to stop.

This endpoint allows you to stop active recordings on a call. Since a call can have multiple ongoing recordings, you can choose to stop a specific recording by providing its URL, or stop all recordings by not providing any parameters.

Note: When a recording is stopped, it will be finalized and made available for download. If you configured a callback_url, it will be invoked with the recording details.

HTTP Request

DELETEhttps://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Record/

Path Parameters

auth_idstringRequired

Your Vobiz authentication ID

call_uuidstringRequired

Unique identifier of the call being recorded

Request Parameters

Request Parameters

NameTypeDescription
URL
stringThe recording URL to stop. If not provided, all active recordings on the call will be stopped.

Default Behavior: If you don't provide the URL parameter, all ongoing recordings on the call will be stopped. To stop only a specific recording, provide the recording URL from the start recording response.

Response

Returns HTTP 204 No Content on success, indicating the recording(s) have been stopped.

Response - 204 No Content
HTTP Status Code: 204

Note: A 204 status code means the request was successful but there is no content to return. The recording has been stopped and will be finalized.

Example Request

Stop All Recordings

cURL Example
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"

Stop Specific Recording

Request Body
{
  "URL": "http://s3.amazonaws.com/recordings_2013/48dfaf60-3b2a-11e3.mp3"
}

Use Cases

  • •Stop recording when sensitive information is about to be shared
  • •End recording after specific call segments (e.g., after survey)
  • •Manually control recording duration based on call events
  • •Stop all recordings when call is being transferred
  • •Finalize recordings before maximum time limit is reached

Tip: After stopping a recording, you can retrieve it using the Recordings API or wait for the callback to receive the download URL.

Start Recording
Play Audio Overview