Delete a file

Required. Send Authorization: Bearer YOUR_API_KEY. You can only delete files you own.

Authorization: Bearer YOUR_API_KEY

Anonymous files: delete with the token from upload: ?fileId=FILE_ID&token=DELETION_TOKEN

Delete a file by id. This cannot be undone.

# Delete a file with API key

curl -X DELETE "https://api.beecargo.net/files/delete?fileId=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Delete an anonymous file with deletion token (no API key needed)

curl -X DELETE "https://api.beecargo.net/files/delete?fileId=550e8400-e29b-41d4-a716-446655440000&token=YOUR_DELETION_TOKEN"

* The token param is only needed when deleting anonymous files without an API key.

Common errors:

// File not found
{
  "success": false,
  "error": "File not found"
}

// Unauthorized (not owner or invalid API key)
{
  "success": false,
  "error": "Unauthorized to delete this file"
}

// Missing file ID
{
  "success": false,
  "error": "File ID is required"
}

• Deletion is permanent
• You can only delete files you own
• The file is removed from storage and the database
• Download stats for that file are removed too