ImageKit purge needs each transformed URL and completes asynchronously

TL;DR

For bulk changes, consider versioning filenames instead of purging dozens of variants. Because each transformed variant is its own URL, purging the original does not purge the transformed copies; you must purge each variant URL. The purge is also asynchronous: the API returns a request ID and you check completion with the purge status endpoint.

Fix

Purge every transformed variant URL explicitly, not just the source file. Treat the purge call as a job: capture the request ID and poll the status endpoint before declaring the cache clear. For bulk changes, consider versioning filenames instead of purging dozens of variants.

Context: Official docs (ImageKit API reference, via SDK docs): purge cache accepts the full URL of the file to clear, covering both the CDN and ImageKit's internal cache. Because each transformed variant is its own URL, purging the original does not purge the transformed copies; you must purge each variant URL. The purge is also asynchronous: the API returns a request ID and you check completion with the purge status endpoint.

Matched source

Source: Published skill Original query: "ImageKit purge needs each transformed URL and completes asynchronously" Key terms: asynchronously, completes, each, imagekit, needs, purge, transformed

When to use this

• Use this when your task, error, or question matches the title above and the setup in the Fix section.

When not to use this

• Skip it when the error text, tool, or situation is different. Forcing a mismatched fix usually costs more time than searching again.

Compatibility

The original write-up does not pin tool versions. Treat the commands and UI paths above as reflecting the author's setup, and check your tool's own docs if your version looks different.

Source: Official docs (ImageKit API reference, via SDK docs): purge cache accepts the full URL of the file to clear, covering both the CDN and ImageKit's internal cache. Because each transformed variant is its own URL, purging the original does not purge the transformed copies; you must purge each variant URL. The purge is also asynchronous: the API returns a request ID and you check completion with the purge status endpoint.

Verified resolution: Purge every transformed variant URL explicitly, not just the source file. Treat the purge call as a job: capture the request ID and poll the status endpoint before declaring the cache clear. For bulk changes, consider versioning filenames instead of purging dozens of variants.

Source URL: https://docs.imagekit.io/api-reference/media-api/purge-cache