Delete multiple files

Overview

Permanently deletes multiple files from the system. This is a bulk operation that allows you to remove several files in a single request. Warning: This action is irreversible.

Request Parameters

Request Body

The request body must contain a JSON object with the following structure:

Request Examples

Single File Deletion

{
  "fileIds": "8123612d-187c-44eb-8ac6-214e68506b7e"
}

Multiple Files Deletion

{
  "fileIds": "8123612d-187c-44eb-8ac6-214e68506b7e,8123612d-187c-44eb-8ac6-214e68506b7f,9234723e-298d-55fc-9bd7-325f79617c8g"
}

Success Response (200 OK)

{
  "success": true
}

Error Responses

400 Bad Request

{
  "error": "Invalid request",
  "message": "fileIds parameter is required and cannot be empty"
}

403 Forbidden

{
  "message": "Access denied. You are in readonly mode.",
  "error": "Forbidden",
  "statusCode": 403
}

422 Unprocessable Entity

{
  "message": "Invalid fileIds.",
  "error": "Unprocessable Entity",
  "statusCode": 422
}

Important Notes

• Irreversible Action: Deleted files cannot be recovered. Ensure you have proper backups before deletion.
• UUID Format: File IDs must be valid UUIDs in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
• Comma Separation: When providing multiple file IDs as a string, separate them with commas without spaces.
• Batch Processing: The endpoint processes all file IDs in a single transaction where possible.
• Partial Failures: If some files cannot be deleted, the operation will complete for valid files and return error details for failed ones.
• Permission Checks: Each file deletion is subject to individual permission validation.

File ID Requirements

• Must be valid UUID format (36 characters including hyphens)
• File must exist in the system
• User must have delete permissions for each file
• Maximum recommended batch size: 100 files per request

Use Cases

• Bulk cleanup of temporary or processed files
• User-initiated deletion of selected files from file manager
• Automated cleanup processes removing expired files
• Storage management operations to free up space
• Data privacy compliance for user data deletion requests

Best Practices

1. Validate file ownership before deletion
2. Implement confirmation dialogs for user-facing operations
3. Log deletion activities for audit purposes
4. Check file dependencies before deletion
5. Use reasonable batch sizes to avoid timeouts
6. Handle partial failures gracefully in your application logic