Skip to main content

​
Endpoint

DELETE /invalidate/{path}
Auth: API Key required

​
Path parameters

​
path
string
required
Path to the file relative to the storage root.photo.jpg · photos/portrait.jpg

​
What gets cleared

  • Local cache — transformation variants stored on disk
  • Cloud cache — transformation variants stored in S3-compatible storage (if configured)
  • In-memory cache — cached metadata entries for the file
The original file is not touched.

​
Response

{
  "success": true,
  "message": "Cache invalidated successfully",
  "details": {
    "localCacheFilesDeleted": 3,
    "cloudCacheFilesDeleted": 0
  }
}
​
success
boolean
true if invalidation completed without errors. May be true even when some steps had non-fatal errors (see details.errors).
​
message
string
Human-readable result summary.
​
details
object
Status codes: 200 success (or partial) · 400 path missing · 500 error

​
Example

curl -X DELETE http://localhost:3000/invalidate/photos/portrait.jpg \
  -H "Authorization: Bearer <api_key>"

Delete File

Permanently remove a file and all its cached variants.

Transform

Apply transformations — results are cached automatically.