Purge

Purge

post

Creates a Purge job for a CDN resource.

This endpoint is available for Small, Large, VOD, and Dynamic (Aksela) resource types.

Wildcard purge is supported. You can include * in file paths to match multiple objects (for example: /images/* or /images/*.jpg).

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidstringRequired

Organization UUID.

Example: ****-*****-****-****

resource_uuidstringRequired

Resource UUID.

Example: ****-*****-****-*****

Body

application/json

resource_uuidstringRequired

Resource UUID (must match the resource_uuid in the path).

Example: ****-****-****-****

file_pathstring[] · min: 1 · max: 100Required

One or more paths to purge. Each entry must be an absolute path starting with /.

Wildcard purge is supported with * (for example: /assets/, /images/.png).

Responses

200

Purge request successfully created.

application/json

400

Bad Request - Invalid body or file_path values.

application/json

401

Unauthorized - Missing or invalid bearer token.

application/json

404

Not Found - Organization or resource not found.

application/json

413

Payload Too Large - Too many file_path entries or oversized payload.

application/json

500

Internal Server Error.

application/json

post

/api/v1/cdn/{organization_uuid}/job/{resource_uuid}/purge

HTTPcURLJavaScriptPython

POST /api/v1/cdn/{organization_uuid}/job/{resource_uuid}/purge HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "resource_uuid": "****-***-****-****-****",
  "file_path": [
    "/example/111/images/20230101_01.jpg"
  ]
}

Purge a single objectWildcard purge (prefix)Wildcard purge (pattern)

{
  "message": "Your purge request has been created successfully.",
  "opID": "0b508058-9c8c-475a-b5e7-0bf9014423b2",
  "status": true
}