Invalidate Cache

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

Show Details

localCacheFilesDeleted

number

Number of cached transformation variants removed from local disk.

cloudCacheFilesDeleted

number

Number of cached transformation variants removed from cloud storage.

errors

string[]

Non-fatal errors encountered during cleanup. Only present when some steps failed.

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.

Video Processing StatusCheck the processing status of a video file by its storage path

Overview

Media

Files

Storage

Cache

Video Processing

API Keys

System

Endpoint

Path parameters

What gets cleared

Response

Example

Delete File

Transform

​Endpoint

​Path parameters

​What gets cleared

​Response

​Example

​Related

Delete File

Transform

Endpoint

Path parameters

What gets cleared

Response

Example

Related