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
}

List Purge Requests

get

Retrieves the status of purge job requests. Available for Small, Large, VOD, and Dynamic Site Acceleration (Aksela) resource types.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

Example: 550e8400-e29b-41d4-a716-446655440000

resource_uuidstringRequired

Unique identifier for the CDN Resource.

Example: 660f9511-f30c-52e5-b827-557766551111

Query parameters

pageinteger · min: 1Required

Page number for pagination (1-based).

Example: 1

limitinteger · min: 1 · max: 100Required

Number of records per page.

Example: 10

opIDstringOptional

Operation ID used to filter specific purge requests.

Example: 0b508058-9c8c-475a-b5e7-0bf9014423b2

Responses

200

Purge request data retrieved successfully.

application/json

401

Unauthorized - Missing or invalid bearer token.

get

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

HTTPcURLJavaScriptPython

GET /api/v1/cdn/{organization_uuid}/job/{resource_uuid}/purge?page=1&limit=10 HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": true,
  "data": {
    "page": 1,
    "total": 1,
    "limit": 10,
    "search": "",
    "requests": [
      {
        "completedAt": "2023-04-14T07:18:40.384Z",
        "message": "Invalid purge request.",
        "purgeID": "0b508058-9c8c-475a-b5e7-0bf9014423b2",
        "status": -1,
        "url": "hidden.mncdn.com/my/images/Fish.jpg"
      }
    ]
  }
}