Skip to main content

DELETE /calls/{callid}/recordings/{uniqueid}

Delete a recorded leg

Scoperecordings:delete
Role permissionAccount Owner role only — any other role is 403 permission_denied, whatever the scopes
CostFree

PERMANENT. The audio is destroyed and there is no recovery — not through this API, not in the portal. Every delete is written to the account's audit log.

The same rules as the portal's delete, plus the rules that decide whether you may hear the recording at all:

  • Account Owner only. For an API key, the key's run-as user must be on the Account Owner role; for an OAuth token, the user who approved the app. Holding recordings:delete is not enough on its own.
  • You must be able to see it. The leg must appear in your own GET /calls/{callid}/recordings listing, so the role's call-report access and an API key's phone number limits apply. A leg you cannot see is 404, the same answer as one that does not exist.
  • Accounts with sensitive-content re-verification on get no API access to recordings, so nothing can be deleted over the API there.

recordings:read does not include deleting, and recordings:delete does not include reading — ask for both if you list before deleting.

Deletes every recording file on the leg. To delete one file of a leg that has several (a recordingId in the listing), use DELETE /calls/{callid}/recordings/{uniqueid}/{recordingid}.

Path parameters​

NameTypeRequiredExampleDescription
callidstringyes1754489201.884213The call id from call history, reports or a call webhook — a unix timestamp, a dot, and a sequence number. A malformed id is a 400 that names the expected shape, not a 404.
uniqueidstringyes1754489201.884213The leg identifier, from uniqueId in the list response.

Responses​

204​

Deleted. No body.

Errors​

StatusMeaning
400invalid_request — a missing or malformed field, an unknown enum value, or an unknown field in the body. Nothing was charged.
401unauthenticated — no credential, or one that is invalid, revoked or expired. The WWW-Authenticate header names the scope the endpoint wanted.
403Two different failures share this status; the type field tells them apart — insufficient_scope (the credential lacks the scope) or permission_denied (the scope is fine, but the user's role lacks the permission).
404not_found — no such object, or it is not this account's. The two are deliberately indistinguishable.
500internal_error — something failed on our side, not with your request. Safe to retry.

See Errors for the full catalog and what to do about each.

Example​

curl -X DELETE 'https://api.account.telebroad.com/api/public/v1/calls/1754489201.884213/recordings/1754489201.884213' \
-H "Authorization: Bearer $TB_KEY"

Try it in the playground →