XFile Ultra
Log inSign up

API bulk delete

Allow POST /api/v1/files/bulk-delete. Default off. Batch size 1-500 (default 100). Single DELETE still works.

Settingtoggle.api_bulk_delete_mod

API bulk delete

When on, members with file:write can trash many files or folders in one request. When off, that endpoint returns 403. Single-file DELETE /api/v1/file/{id} still works.

Where to find it

Admin → Settings → Mods → API → API bulk delete

Field Key Default
Enable toggle.api_bulk_delete_mod off
Bulk delete batch size api_bulk_delete_max 100 (range 1-500)

Example

curl -X POST "https://YOUR-DOMAIN/api/v1/files/bulk-delete" \
  -H "Authorization: Bearer YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"ids":["fileId1","folderId2"]}'

Folder IDs delete the folder and nested files (soft-delete / trash rules still apply).

Common problems

Accidental mass trash

Keep batch size modest; restore from trash while retention allows.

403 on bulk-delete only

This toggle is off - single DELETE is unrelated.

Related