Flutter: purgeCache

Invalidates the CDN cache for a single object in a bucket.

• Requires the secret key and the purgeCache feature enabled for your project on the storage server.
• When transformations is true, only the resized/formatted variants are purged, leaving the original cached object intact. Otherwise the object's cache is purged.
• Policy permissions required:
  • buckets permissions: none
  • objects permissions: select
• Refer to the Storage guide on how access control works

Parameters

• path

  (Required)

  The path and name of the object to purge from the CDN cache. For example folder/image.png.

• transformations

  (Optional)

  When true, only the transformed (resized/formatted) variants are purged, leaving the original cached object intact. Defaults to false.

Examples

Purge the CDN cache for an object

final String res = await supabase
  .storage
  .from('avatars')
  .purgeCache('avatar1.png');

Purge only the transformed variants

final String res = await supabase
  .storage
  .from('avatars')
  .purgeCache('avatar1.png', transformations: true);