POST/image/purge/{source_id}

Purge Image Cache

You can purge the cache for any image path by using this cache purge API.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
source_idstringrequired

Image Source ID

pathsarray<string>required

An array of path of images to purge. It should be provided without any query parameters.

4 status codes
200Successful response
statusstringrequired
400Bad Request

One documented failure

  • source_not_found

    Could not find any image source with the specified source_id.

errorobjectrequired
401Unauthorized — missing or invalid API key / bearer token

One documented failure

  • invalid_api_key

    API key supplied with request is invalid

errorobjectrequired
403Forbidden — unpaid account or insufficient role permissions

One documented failure

  • unauthorized

    You don't have access to this feature. Please contact your organization owner.

errorobjectrequired

Error handling

A 400 is returned: Bad Request. A 401 is returned: Unauthorized — missing or invalid API key / bearer token. A 403 is returned: Forbidden — unpaid account or insufficient role permissions.