Skip to main content
DELETE
Delete a recording
Requires Admin or Owner. The path uses the string recording ID, not the numeric row ID. This removes the audio, transcript, and associated metadata. Update agents that use the recording before deleting it. Successful deletion returns 200 with a success message; a missing recording returns 404.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Path Parameters

recording_id
string
required

Response

Successful Response

message
string
required
success
boolean
required