DELETE
/
v1
/
storage
/
file
/
{fileKey}
curl -X DELETE https://api.verbalisai.com/v1/storage/file/user123/audio-recording-1642234567.mp3 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "message": "File deleted successfully",
  "data": {
    "fileKey": "user123/audio-recording-1642234567.mp3",
    "deletedAt": "2024-01-15T10:30:00Z"
  }
}

Permanently delete a file from R2 storage. This action cannot be undone.

This endpoint requires authentication via API key.

​
fileKey
string
required

The unique file key of the file to delete

curl -X DELETE https://api.verbalisai.com/v1/storage/file/user123/audio-recording-1642234567.mp3 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "message": "File deleted successfully",
  "data": {
    "fileKey": "user123/audio-recording-1642234567.mp3",
    "deletedAt": "2024-01-15T10:30:00Z"
  }
}

​
Response Fields

​
success
boolean

Indicates if the deletion was successful

​
message
string

Human-readable confirmation message

​
data
object

​
Important Notes

  • File deletion is permanent and cannot be undone
  • Any transcriptions or other services referencing this file may become inaccessible
  • You can only delete files that belong to your account
  • Rate limiting applies to deletion operations