Page Rule

Disallow Cache Rule

put

Disallows caching for the specified URI path(s) on a Dynamic (Aksela) resource.

Note: The resource_uuid value in the request body must match the {resource_uuid} path parameter.

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.

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

Responses

200

Disallow Cache Rule updated successfully.

application/json

400

Bad Request - Invalid or missing parameters.

application/json

404

Resource not found.

application/json

500

Internal Server Error.

application/json

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

HTTPcURLJavaScriptPython

PUT /api/v1/cdn/{organization_uuid}/resource/{resource_uuid} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "resource_uuid": "****-****-****-****",
  "exclude_cache": {
    "uri": [
      "/domain.test.com"
    ],
    "status_exact_match": [
      false
    ]
  }
}

Disallow caching for a path (subpaths included)Disallow caching for an exact path only

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-*****",
    "resource_type": "dynamic",
    "exclude_cache": {
      "uri": [
        "domain.test.com"
      ],
      "status_exact_match": [
        true
      ]
    }
  }
}

Custom Error Pages

put

Enables or updates Custom Error Pages for a resource. This setting is available for all resource types.

Note: The resource_uuid value in the request body must match the {resource_uuid} path parameter.

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.

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

custom_error_pages_statusbooleanRequired

Enables or disables Custom Error Pages.

Example: true

Responses

200

Custom Error Pages updated successfully.

application/json

400

Bad Request - Invalid or missing parameters.

application/json

404

Resource not found.

application/json

500

Internal Server Error.

application/json

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

HTTPcURLJavaScriptPython

PUT /api/v1/cdn/{organization_uuid}/resource/{resource_uuid} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 181

{
  "resource_uuid": "*****-***-***-***",
  "custom_error_pages_status": true,
  "custom_error_pages": [
    {
      "status_code": 404,
      "url": "https://my.domain.com/404.html",
      "redirect_status_code": "302"
    }
  ]
}

Enable a custom 404 pageEnable multiple custom error pagesDisable Custom Error Pages (keep configuration empty)

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-*****",
    "resource_type": "dynamic",
    "custom_error_pages_status": true,
    "custom_error_pages": [
      {
        "status_code": 404,
        "url": "https://my.domain.com/404.html",
        "redirect_status_code": "302"
      }
    ]
  }
}

Page Rule Query String - Retain All

put

Updates Query String handling for one or more Page Rules on a resource. This setting is available for small, large, and dynamic (Aksela) resource types.

Retain All means Query String parameters are kept and evaluated as part of cache behavior according to the rule configuration.

Note: Page Rules are updated by rule_id.

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

Responses

200

Query String settings updated successfully.

application/json

400

Bad Request - Invalid or missing parameters.

application/json

404

Resource not found.

application/json

500

Internal Server Error.

application/json

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

HTTPcURLJavaScriptPython

PUT /api/v1/cdn/{organization_uuid}/resource/{resource_uuid} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "page_rule": [
    {
      "rule_id": 2,
      "status_qs": "on",
      "status_qs_cache_ignore": false,
      "status_cqs": false
    }
  ]
}

Retain all Query String parametersDisable Query String handling on a page ruleRetain Query String but ignore it for caching decisions

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-*****",
    "resource_type": "dynamic",
    "page_rule": [
      {
        "rule_id": 2,
        "status_qs": "on",
        "status_qs_cache_ignore": false,
        "status_cqs": false
      }
    ]
  }
}

Page Rule Query String - Ignore All

put

Updates Query String handling for one or more Page Rules on a resource. This setting is available for small, large, and dynamic (Aksela) resource types.

Ignore All means Query String parameters are ignored for the page rule behavior (i.e., the rule treats URLs as if they have no Query String).

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

Responses

200

Query String settings updated successfully.

application/json

400

Bad Request - Invalid or missing parameters.

application/json

404

Resource not found.

application/json

500

Internal Server Error.

application/json

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

HTTPcURLJavaScriptPython

PUT /api/v1/cdn/{organization_uuid}/resource/{resource_uuid} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "page_rule": [
    {
      "rule_id": 2,
      "status_qs": "off"
    }
  ]
}

Ignore all Query String parametersEnable Query String handling on a page rule

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-*****",
    "resource_type": "dynamic",
    "page_rule": [
      {
        "rule_id": 2,
        "status_qs": "off"
      }
    ]
  }
}

Page Rule Query String - Retain Specific

put

Updates Query String handling for one or more Page Rules on a resource. This setting is available for small, large, and dynamic (Aksela) resource types.

Retain Specific means the cache key includes only the selected Query String parameters (the rest are ignored).

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

Responses

200

Query String settings updated successfully.

application/json

400

Bad Request - Invalid or missing parameters.

application/json

404

Resource not found.

application/json

500

Internal Server Error.

application/json

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

HTTPcURLJavaScriptPython

PUT /api/v1/cdn/{organization_uuid}/resource/{resource_uuid} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 152

{
  "page_rule": [
    {
      "rule_id": 2,
      "status_qs": "on",
      "status_qs_cache_ignore": false,
      "qs_cache_ignore_param": [],
      "status_cqs": true,
      "cqs_args": [
        "version",
        "page"
      ]
    }
  ]
}

Retain only selected Query String parametersRetain specific parameters and also define ignore list

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-*****",
    "resource_type": "dynamic",
    "page_rule": [
      {
        "rule_id": 2,
        "status_qs": "on",
        "status_qs_cache_ignore": false,
        "qs_cache_ignore_param": [],
        "status_cqs": true,
        "cqs_args": [
          "version",
          "page"
        ]
      }
    ]
  }
}

Page Rule Query String - Ignore Specific

put

Updates Query String handling for one or more Page Rules on a resource. This setting is available for small, large, and dynamic (Aksela) resource types.

Ignore Specific means the cache key includes all Query String parameters except the specified ones.

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

Responses

200

Query String settings updated successfully.

application/json

400

Bad Request - Invalid or missing parameters.

application/json

404

Resource not found.

application/json

500

Internal Server Error.

application/json

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

HTTPcURLJavaScriptPython

PUT /api/v1/cdn/{organization_uuid}/resource/{resource_uuid} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 145

{
  "page_rule": [
    {
      "rule_id": 2,
      "status_qs": "on",
      "status_qs_cache_ignore": true,
      "qs_cache_ignore_param": [
        "version"
      ],
      "status_cqs": false,
      "cqs_args": []
    }
  ]
}

Ignore selected Query String parametersIgnore multiple parameters (max 25)

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-*****",
    "resource_type": "dynamic",
    "page_rule": [
      {
        "rule_id": 2,
        "status_qs": "on",
        "status_qs_cache_ignore": true,
        "qs_cache_ignore_param": [
          "version"
        ],
        "status_cqs": false,
        "cqs_args": []
      }
    ]
  }
}

Delete Page Rule

put

Deletes one or more Page Rules by marking them with is_delete=true in the request payload.

This action updates the Page Rule configuration on the resource. The status_file_extension field controls whether Page Rule processing by file extension is enabled at the resource level.

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.

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

status_file_extensionbooleanRequired

Enables or disables Page Rule evaluation by file extension at the resource level.

Example: true

Responses

200

Page Rule(s) deleted successfully.

application/json

400

Bad Request - Invalid or missing parameters.

application/json

404

Resource or Page Rule not found.

application/json

500

Internal Server Error.

application/json

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

HTTPcURLJavaScriptPython

PUT /api/v1/cdn/{organization_uuid}/resource/{resource_uuid} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "resource_uuid": "****-****-****-****",
  "status_file_extension": true,
  "page_rule": [
    {
      "rule_id": 2,
      "is_delete": true
    }
  ]
}

Delete a single Page RuleDelete multiple Page Rules

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-*****",
    "resource_type": "dynamic",
    "status_file_extension": true,
    "page_rule": [
      {
        "rule_id": 1,
        "file_path": "",
        "file_extension": [
          "png",
          "js",
          "css",
          "jpg",
          "woff",
          "woff2"
        ]
      }
    ]
  }
}