> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bota.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Recording

> Permanently delete a recording

Permanently delete a recording and its associated audio file and transcriptions. This action cannot be undone.

## Authentication

Requires an [API key](/authentication) with `recordings:write` scope.

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.bota.dev/v1/recordings/rec_abc123 \
    -H "Authorization: Bearer sk_live_..."
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.bota.dev/v1/recordings/rec_abc123', {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer sk_live_...',
    },
  });

  // 204 No Content on success
  if (response.status === 204) {
    console.log('Recording deleted');
  }
  ```

  ```python Python theme={null}
  import requests

  response = requests.delete(
      'https://api.bota.dev/v1/recordings/rec_abc123',
      headers={'Authorization': 'Bearer sk_live_...'},
  )

  if response.status_code == 204:
      print('Recording deleted')
  ```
</RequestExample>

## Path Parameters

<ParamField path="id" type="string" required>
  The recording's unique identifier (e.g., `rec_abc123`).
</ParamField>

## Response

Returns `204 No Content` on success.

<ResponseExample>
  ```json 204 theme={null}
  // No content
  ```

  ```json 404 theme={null}
  {
    "error": {
      "code": "not_found",
      "message": "Recording not found"
    }
  }
  ```
</ResponseExample>

<Warning>
  This action permanently deletes the recording, its audio file from S3, and all associated transcriptions. This cannot be undone.
</Warning>