Caching

Edge Cache Expiration

put

Updates the Edge Cache Expiration settings for a CDN resource. Available for small and large resource types.

Path parameters

organization_uuidstring · uuidRequired

The UUID of the organization.

resource_uuidstring · uuidRequired

The UUID of the CDN resource to update.

Body

resource_uuidstringRequired

The UUID of the resource.

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

cache_typestring · enumRequired

Defines the cache type to update.

Example: edgePossible values:

edge_cache_expiryinteger · min: 1 · max: 365Optional

Duration for which the edge cache remains valid. Required when cache_type is 'edge'.

Example: 6

edge_cache_unitstring · enumOptional

Unit of the edge cache duration. Required when cache_type is 'edge'.

Example: dPossible values:

Responses

200

Edge Cache Expiration updated successfully.

application/json

put

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

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

{
  "resource_uuid": "****-****-****-****",
  "cache_type": "edge",
  "edge_cache_expiry": 6,
  "edge_cache_unit": "d"
}

200

Edge Cache Expiration updated successfully.

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-****",
    "resource_name": "test.sm",
    "resource_type": "small",
    "cdn_url": "test.sm.mncdn.com",
    "cache_type": "edge",
    "edge_cache_expiry": 8,
    "edge_cache_unit": "d",
    "status_browser_cache": true,
    "browser_cache_expiry": 1,
    "browser_cache_unit": "origin",
    "status_geo_blocking": false,
    "status_secure_token": false,
    "status_hl_protection": false,
    "ssl_status": true,
    "http2": true,
    "brotli": false,
    "gzip_text": false,
    "gzip_image": false,
    "image_optimization": false,
    "created_at": "2025-08-06T11:39:51.000000Z",
    "updated_at": "2025-08-07T10:40:46.000000Z"
  }
}

Browser Cache Rules

put

Updates the browser cache rules for a specific CDN resource. A maximum of 15 rules can be defined. Available for small, large, and dynamic (Aksela) resource types.

Path parameters

organization_uuidstring · uuidRequired

UUID of the organization.

resource_uuidstring · uuidRequired

UUID of the CDN resource to update.

Body

resource_uuidstringRequired

UUID of the CDN resource.

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

browser_cache_with_htmlbooleanOptional

Controls whether HTML content is cached by the browser.

Example: false

Responses

200

Browser cache rules updated successfully.

application/json

put

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

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

{
  "resource_uuid": "****-****-****-****",
  "browser_cache_rules": [
    {
      "type": "all_files",
      "priority": 50,
      "cache_mode": "origin",
      "cache_time": 0,
      "directive": [],
      "exact_match": false
    },
    {
      "type": "full_path",
      "content": [
        "/example/images.jpg"
      ],
      "priority": 40,
      "cache_mode": "cache",
      "cache_time": 60,
      "directive": [
        "must-revalidate",
        "public",
        "private"
      ],
      "exact_match": false
    },
    {
      "type": "directory",
      "content": [
        "/test",
        "/test1/"
      ],
      "priority": 100,
      "cache_mode": "no_cache",
      "cache_time": 0,
      "directive": [],
      "exact_match": false
    },
    {
      "type": "file_extension",
      "content": [
        ".png",
        ".jpg"
      ],
      "priority": 30,
      "cache_mode": "cache",
      "cache_time": 30,
      "directive": [
        "must-revalidate",
        "no-cache",
        "no-store",
        "no-transform",
        "public",
        "private",
        "proxy-revalidate"
      ],
      "exact_match": false
    }
  ],
  "browser_cache_with_html": false
}

200

Browser cache rules updated successfully.

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-****",
    "resource_name": "test.sm",
    "cdn_url": "test.sm.mncdn.com",
    "resource_type": "small",
    "browser_cache_rules": [
      {
        "id": 1,
        "type": "all_files",
        "cache_mode": "origin",
        "exact_match": false
      }
    ],
    "browser_cache_with_html": false,
    "status_browser_cache": true,
    "cache_type": "edge",
    "edge_cache_expiry": 8,
    "edge_cache_unit": "d",
    "ssl_status": true,
    "http2": true,
    "brotli": false,
    "gzip_text": false,
    "gzip_image": false,
    "image_optimization": false,
    "created_at": "2025-08-06T11:39:51.000000Z",
    "updated_at": "2025-08-07T10:40:46.000000Z"
  }
}

Query String Caching

put

Updates the Query String Caching settings for a specific CDN resource. Available for small and dynamic (Aksela) resource types.

Path parameters

organization_uuidstring · uuidRequired

UUID of the organization.

resource_uuidstring · uuidRequired

UUID of the CDN resource to update.

Body

resource_uuidstringRequired

UUID of the CDN resource.

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

status_qsstring · enumRequired

Determines query string caching behavior. Options: on, off, or request_uri.

Example: onPossible values:

status_qs_cache_ignorebooleanRequired

Specifies whether query string caching should be ignored.

Example: true

status_cqsbooleanRequired

Indicates if caching query string parameters (CQS) is enabled.

Example: false

qs_cache_ignore_paramstring[] · max: 25Optional

List of query string parameters to ignore for caching.

Example: ["test"]

Responses

200

Query string caching settings updated successfully.

application/json

put

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

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

{
  "resource_uuid": "****-****-****-****",
  "status_qs": "on",
  "status_qs_cache_ignore": true,
  "status_cqs": false,
  "qs_cache_ignore_param": [
    "test"
  ]
}

200

Query string caching settings updated successfully.

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-****",
    "resource_name": "test.sm",
    "resource_type": "small",
    "cdn_url": "test.sm.mncdn.com",
    "status_qs": "on",
    "status_qs_cache_ignore": false,
    "qs_cache_ignore_param": [],
    "status_cqs": false,
    "status_browser_cache": true,
    "browser_cache_expiry": 1,
    "browser_cache_unit": "origin",
    "ssl_status": true,
    "http2": true,
    "brotli": false,
    "gzip_text": false,
    "gzip_image": false,
    "image_optimization": false,
    "created_at": "2025-08-06T11:39:51.000000Z",
    "updated_at": "2025-08-07T10:40:46.000000Z"
  }
}

ETag Verification

put

Updates the ETag verification status for a CDN resource. This setting is available for small, large, and dynamic (Aksela) resource types.

Path parameters

organization_uuidstring · uuidRequired

UUID of the organization.

resource_uuidstring · uuidRequired

UUID of the CDN resource.

Body

status_etag_verificationbooleanRequired

Enables or disables ETag verification for the resource.

Example: true

Responses

200

ETag verification updated successfully.

application/json

put

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

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

{
  "status_etag_verification": true
}

200

ETag verification updated successfully.

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-****",
    "resource_name": "test.sm",
    "resource_type": "small",
    "cdn_url": "test.sm.mncdn.com",
    "status_etag_verification": true,
    "etag_verification_type": "default",
    "ssl_status": true,
    "http2": true,
    "brotli": false,
    "gzip_text": false,
    "gzip_image": false,
    "image_optimization": false,
    "cache_type": "edge",
    "edge_cache_expiry": 8,
    "edge_cache_unit": "d",
    "browser_cache_expiry": 1,
    "browser_cache_unit": "origin",
    "created_at": "2025-08-06T11:39:51.000000Z",
    "updated_at": "2025-08-07T10:40:46.000000Z"
  }
}

Error Status Code Cache Expiration

put

Updates the cache expiration duration for specific error status codes. This setting is available for small, large, and dynamic (Aksela) resource types.

Path parameters

organization_uuidstring · uuidRequired

UUID of the organization.

resource_uuidstring · uuidRequired

UUID of the CDN resource.

Body

Responses

200

Error status code cache expiration updated successfully.

application/json

put

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

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

{
  "status_code_cache": [
    {
      "status_codes": [
        500,
        501
      ],
      "cache_expiry": 5,
      "cache_unit": "m"
    },
    {
      "status_codes": [
        400
      ],
      "cache_expiry": 1,
      "cache_unit": "m"
    }
  ]
}

200

Error status code cache expiration updated successfully.

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-****",
    "resource_name": "test.sm",
    "cdn_url": "test.sm.mncdn.com",
    "resource_type": "small",
    "status_code_cache": [
      {
        "status_codes": [
          500,
          501
        ],
        "cache_expiry": 5,
        "cache_unit": "m"
      },
      {
        "status_codes": [
          400
        ],
        "cache_expiry": 1,
        "cache_unit": "m"
      }
    ],
    "ssl_status": true,
    "http2": true,
    "brotli": false,
    "gzip_text": false,
    "gzip_image": false,
    "image_optimization": false,
    "cache_type": "edge",
    "edge_cache_expiry": 8,
    "edge_cache_unit": "d",
    "browser_cache_expiry": 1,
    "browser_cache_unit": "origin",
    "created_at": "2025-08-06T11:39:51.000000Z",
    "updated_at": "2025-08-07T10:40:46.000000Z"
  }
}

Shared Cache

put

Updates shared cache configuration for a CDN resource. This setting is available for small, large, and dynamic (Aksela) resource types.

Path parameters

organization_uuidstring · uuidRequired

UUID of the organization.

resource_uuidstring · uuidRequired

UUID of the CDN resource.

Body

status_share_cachestring · enumRequired

Determines whether the shared cache process is active. Options: default or share.

Example: sharePossible values:

share_cachestringRequired

Domain of the resource that participates in shared caching.

Example: static-test.mncdn.org

Responses

200

Shared cache settings updated successfully.

application/json

put

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

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

{
  "status_share_cache": "share",
  "share_cache": "static-test.mncdn.org"
}

200

Shared cache settings updated successfully.

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-****",
    "resource_name": "static-test.mncdn.org",
    "resource_type": "small",
    "cdn_url": "static-test.mncdn.org",
    "status_share_cache": "share",
    "share_cache": "static-test.mncdn.org",
    "ssl_status": true,
    "http2": true,
    "created_at": "2025-08-06T11:39:51.000000Z",
    "updated_at": "2025-08-07T10:40:46.000000Z"
  }
}

Stale Cache

put

Updates the stale caching configuration for a CDN resource. This setting is available for small, large, and dynamic (Aksela) resource types.

Path parameters

organization_uuidstring · uuidRequired

UUID of the organization.

resource_uuidstring · uuidRequired

UUID of the CDN resource.

Body

Responses

200

Stale caching settings updated successfully.

application/json

put

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

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

{
  "stale_caching": [
    "error",
    "timeout",
    "invalid_header",
    "http_500",
    "http_502",
    "http_503",
    "http_504"
  ]
}

200

Stale caching settings updated successfully.

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-****",
    "resource_name": "test.sm",
    "cdn_url": "test.sm.mncdn.com",
    "resource_type": "small",
    "stale_caching": [
      "error",
      "timeout",
      "invalid_header",
      "http_500",
      "http_502",
      "http_503",
      "http_504"
    ],
    "ssl_status": true,
    "http2": true,
    "brotli": false,
    "gzip_text": false,
    "gzip_image": false,
    "image_optimization": false,
    "cache_type": "edge",
    "edge_cache_expiry": 8,
    "edge_cache_unit": "d",
    "browser_cache_expiry": 1,
    "browser_cache_unit": "origin",
    "created_at": "2025-08-06T11:39:51.000000Z",
    "updated_at": "2025-08-07T10:40:46.000000Z"
  }
}

Robots.txt File

put

Updates robots.txt configuration for a CDN resource. This setting is available for small and large resource types.

Path parameters

organization_uuidstring · uuidRequired

UUID of the organization.

resource_uuidstring · uuidRequired

UUID of the CDN resource.

Body

resource_uuidstringRequired

UUID of the resource.

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

status_robot_txtstring · enumRequired

Determines the robots.txt behavior for the resource. Options: enabled, disabled, or origin.

Example: originPossible values:

Responses

200

Robots.txt settings updated successfully.

application/json

put

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

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

{
  "resource_uuid": "****-****-****-****",
  "status_robot_txt": "origin"
}

200

Robots.txt settings updated successfully.

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-****",
    "resource_name": "test.sm",
    "cdn_url": "test.sm.mncdn.com",
    "resource_type": "small",
    "status_robot_txt": "origin",
    "ssl_status": true,
    "http2": true,
    "brotli": false,
    "gzip_text": false,
    "gzip_image": false,
    "image_optimization": false,
    "cache_type": "edge",
    "edge_cache_expiry": 8,
    "edge_cache_unit": "d",
    "browser_cache_expiry": 1,
    "browser_cache_unit": "origin",
    "created_at": "2025-08-06T11:39:51.000000Z",
    "updated_at": "2025-08-07T10:40:46.000000Z"
  }
}

Range Based Caching

put

Updates the range-based caching configuration for a CDN resource. This setting is available for small and large resource types.

Path parameters

organization_uuidstring · uuidRequired

UUID of the organization.

resource_uuidstring · uuidRequired

UUID of the CDN resource.

Body

status_range_based_cachingbooleanRequired

Enables or disables range-based caching.

Example: true

Responses

200

Range-based caching settings updated successfully.

application/json

put

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

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

{
  "status_range_based_caching": true
}

200

Range-based caching settings updated successfully.

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-****",
    "resource_name": "test.sm",
    "cdn_url": "test.sm.mncdn.com",
    "resource_type": "small",
    "status_range_based_caching": true,
    "range_based_caching_value": "512k",
    "ssl_status": true,
    "http2": true,
    "brotli": false,
    "gzip_text": false,
    "gzip_image": false,
    "cache_type": "edge",
    "edge_cache_expiry": 8,
    "edge_cache_unit": "d",
    "browser_cache_expiry": 1,
    "browser_cache_unit": "origin",
    "created_at": "2025-08-06T11:39:51.000000Z",
    "updated_at": "2025-08-07T10:40:46.000000Z"
  }
}

PreviousCNAME & SSL NextHeaders

Last updated 8 days ago

Was this helpful?