> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openinary.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Delete File
> Permanently delete a file from storage along with all its cached transformation variants
This action is irreversible. The file and all its cached variants are permanently removed.
## Endpoint
```
DELETE /storage/{path}
```
**Auth:** API Key required
## Path parameters
Path to the file relative to the storage root. Use the `id` from [List Storage](/api-reference/storage/list).
`photo.jpg` · `photos/portrait.jpg`
## Response
```json theme={null}
{
"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).
**Status codes:** `200` success (or partial) · `400` path is a directory · `404` not found · `500` error
## Example
```bash theme={null}
curl -X DELETE http://localhost:3000/storage/photos/portrait.jpg \
-H "Authorization: Bearer "
```
## Cache-only invalidation
To clear cached variants without deleting the original file, use [Invalidate Cache](/api-reference/cache/invalidate) instead.
## Related
Clear cached variants while keeping the original.
Browse all files before deleting.
Move instead of deleting.