Docs
Callsv4

Delete a call recording

DELETE/calls/{callId}/recording

Delete a call's recording before its retention period ends. It can't be recovered. A recording that failed or is already deleted is returned as it is. OAuth apps need calls:write.

Path parameters

callIdRequiredstring

Call id (call_...).

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

dataoptionalCallRecording
call_idRequiredstring

The recorded call (call_...).

statusRequiredstring

ready to play or download, failed when the call couldn't be recorded, deleted once deleted or past the organization's retention period.

"ready""failed""deleted"
started_atRequiredinteger | null

Epoch ms.

ended_atRequiredinteger | null

Epoch ms.

duration_msRequiredinteger | null
errorRequiredobject | null
object
codeRequiredstring
messageRequiredstring
null
download_urloptionalstring | null

MP3, dual channel (one side of the call per channel), valid for 10 minutes. Only GET returns it, and only for a ready recording.

Response codes

200The recording, now `deleted`
400`invalid_call_id`: the id is not a `call_...` id.
401Your API key is missing or invalid. Pass it as a bearer token.
404`recording_not_found`: the call wasn't recorded, or its recording isn't saved yet.
422`recording_unavailable`: the carrier refused the deletion.
502`upstream_unavailable`: the carrier network couldn't be reached. Retry with backoff.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X DELETE https://api.blooio.com/v4/calls/obj_a1b2c3d4/recording \
Response objectexample
{  "data": {    "call_id": "obj_a1b2c3d4",    "status": "ready",    "started_at": 0,    "ended_at": 0,    "duration_ms": 1200,    "error": {      "code": "string",      "message": "Hello from Blooio!"    },    "download_url": "https://example.com"  }}