This action is irreversible. The file and all its cached variants are permanently removed.
Endpoint
Auth: API Key required
Path parameters
Path to the file relative to the storage root. Use the id from List Storage.photo.jpg · photos/portrait.jpg Response
{
"success": true,
"message": "File deleted successfully",
"details": {
"jobsDeleted": 0,
"localCacheFilesDeleted": 3,
"cloudCacheFilesDeleted": 0,
"errors": []
}
}
true if the original file was deleted. May be true even when some cache cleanup had errors.
Human-readable result summary.
Number of queued processing jobs cancelled and removed.
Number of cached transformation variants removed from local disk.
Number of cached transformation variants removed from cloud storage.
Non-fatal cleanup errors (e.g. a cache variant that was already missing).
200 success (or partial) · 400 path is a directory · 404 not found · 500 error
Example
curl -X DELETE http://localhost:3000/storage/photos/portrait.jpg \
-H "Authorization: Bearer <api_key>"
Cache-only invalidation
To clear cached variants without deleting the original file, use Invalidate Cache instead.
Invalidate Cache
Clear cached variants while keeping the original.
List Storage
Browse all files before deleting.
