UPDATE: this topic was recently added to our documentation section.
When uploading/deleting via the UI, a CDN invalidation request is being sent along automatically. When using the API, the
invalidate flag must be set to true (default is false)
It's important to know that Cloudinary only invalidates certain variants of URLs according to the following policy:
- A resource located in root (e.g.
Only the unversioned URL will be invalidated by default: https://res.cloudinary.com/demo/image/upload/sample.jpg
- A resource located within a folder hierarchy (e.g.
Only the "v1/" versioned URL will be invalidated by default: https://res.cloudinary.com/demo/image/upload/v1/folder/subfolder/sample.jpg
This policy derives from the SDK helper methods behavior in regards to constructing the URLs. One can ask to change this behavior globally on his account to invalidate only unversioned URLs for both scenarios (root/folders).
Another thing to take into consideration is that URL paths are case sensitive. Therefore:
is different than (capital S):
In such case Cloudinary will use the public ID which was originally used to store the resource.