Skip to main content

Purge

POST 
/api/v1/cdn/purge

This API provides purge option for cached CDN assets. You can use this to purge cached assets. See [CDN Asset Prefetch] for types of cached assets you can purge.

Note:

  • API payload can have upto 1000 asset URLs
  • The asset_urls parameter should be valid video or image url parts
  • If the CDN Asset URL is not public, it must be a signed URL part
    • see [Signing Video URLs]
    • see [Signing Image URLs]
    • see [Asset Get Link API]

Note: CDN purge requests are throttled to prevent abuse. Please use purge with appropriate expiry to reduce volume of purge requests.If you have more than a few assets to purge, we recommend that you batch them in one API call.

REQUEST JSON​

The request body should be a JSON as below.

{
  "asset_urls": [
    "/api/v1/assets/f99255d2bf8142b29561641491e9940c/transcodes/480p-video.mp4",
    "/api/v1/assets/f99255d2bf8142b29561641491e9940c/transcodes/480p-video.mp4?expiry=1452894790&accessId=IZJTAMBQGAYDAMBQGAYDAMBQGAYDANKT&signature=vsR0_NFfeLEJPc8MXWMh2xI2Qvg%3D",
    "/api/v1/assets/0c3c6d026858460abc4de1dcb4de15ac/conversions?resize=200,200",
    "/api/v1/assets/0c3c6d026858460abc4de1dcb4de15ac/conversions?resize=200,200&expiry=1510659108&accessId=IZJTAMBQGAYDAMBQGAYDAMBQDBYDAMBR&signature=dwtRLuuL0PSmC-ZoIsh5zerMguc%3D",
    "/api/v1/files/content/0c3c6d026858460abc4de1dcb4de15ac?key=original&expiry=1510659108&accessId=IZJTAMBQGAYDAMBQGAYDAMBQDBYDAMBR&signature=dwtRLuuL0PSmC-ZoIsh5zerMguc%3D"
  ]
}
KeyValueDescription
asset_urlslistList of asset URLs parts. Maximum of 1000 URLs

Request​

Responses​

Successful operation