CacheUpdate Cache

Update Cache

Update Cache HTTP Push Zone

curl -X POST "https://api.5centscdn.com/v2/zones/http/pull/42/cache" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "cache": "1h",
  "expiry": "1d",
  "querystring": "Y",
  "cachecontrol": "Y",
  "usestale": "Y",
  "revalidate": "Y",
  "cacheInSecs": 3600,
  "cacheInMins": 60,
  "expiryInSecs": 86400,
  "expiryInMins": 1440
}'
{
  "result": "success",
  "message": "Zone updated successfully",
  "zone": {
    "type": "pull",
    "id": 12345,
    "serviceid": 67890,
    "mode": "http",
    "cnames": "",
    "edgeruleids": 0,
    "deleted": null,
    "name": "my-cdn-zone",
    "hashid": "abc123def456",
    "fqdn": "cdn.example.com",
    "edgerules": {
      "enabled": "N"
    },
    "domainlock": {
      "policy": "N",
      "list": "example.com,cdn.example.com",
      "ips": "203.0.113.10",
      "noreferer": "N",
      "type": "push",
      "enabled": "N",
      "active": "N"
    },
    "geoblock": {
      "policy": "N",
      "list": [
        "US",
        "GB"
      ],
      "ips": "203.0.113.10",
      "enabled": "N",
      "active": "N"
    },
    "securetoken": {
      "policy": "F",
      "keyip": "N",
      "list": "ab12cd34ef56gh78",
      "timeout": 3600,
      "session": "0",
      "ips": "",
      "dirs": "",
      "enabled": "N",
      "active": "N"
    },
    "eac": {
      "policy": "N",
      "list": "http://example.com/auth.script",
      "ips": "203.0.113.10",
      "enabled": "N",
      "active": "N"
    },
    "ssl": {
      "http": "N",
      "http2": "Y",
      "redirect": "Y",
      "mode": "S",
      "certid": null,
      "zerossl": null,
      "enabled": "Y",
      "warning": false
    },
    "cache": {
      "smart": "0",
      "cache": "4h",
      "expiry": "1M",
      "querystring": "N",
      "cachecontrol": "Y",
      "usestale": "Y",
      "revalidate": "Y",
      "cacheInSecs": 14400,
      "cacheInMins": 240,
      "expiryInSecs": 2592000,
      "expiryInMins": 43200
    },
    "edge": {
      "compression": "N",
      "compressionlevel": 5,
      "disposition": "N",
      "stripcookie": "N",
      "xff": "N",
      "cors": "Y",
      "webp": "N",
      "pseudostreaming": "N",
      "wp": "N",
      "lfo": "Y",
      "prefresh": "N"
    },
    "shield": {
      "shields": [
        "CA",
        "FR"
      ]
    },
    "waf": {
      "enabled": "N"
    },
    "seo": {
      "id": 12345,
      "type": "pull",
      "canonical": "N",
      "mode": "default",
      "robots": "N",
      "robotstxt": "N",
      "robotstxtcustom": ""
    },
    "ftpdetails": {
      "username": "user_67890_push_12345",
      "password": "••••••••"
    },
    "ssl_enabled": "Y"
  }
}
POST
/zones/http/pull/{zoneid}/cache
POST
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)
X-API-Keystring
Required

API key (sent in header)

Content-Typestring
Required

The media type of the request body

Options: application/json
cachestring

Edge cache TTL duration code.

Options: 0s, 10s, 1m, 10m, 30m, 1h, 4h, 12h, 1d, 7d, 14d, 1M, 3M, 6M, 1y
expirystring

Browser cache TTL duration code. Same values as cache, or empty string to disable.

querystringstring

Cache content per unique query string.

Options: Y, N
cachecontrolstring

Honour Cache-Control headers from origin.

Options: Y, N
usestalestring

Serve stale content while revalidating in the background.

Options: Y, N
revalidatestring

Revalidate cached content on expiry.

Options: Y, N
cacheInSecsnumber

Cache TTL in seconds - computed from cache value.

cacheInMinsnumber

Cache TTL in minutes - computed from cache value.

expiryInSecsnumber

Browser cache TTL in seconds - computed from expiry value.

expiryInMinsnumber

Browser cache TTL in minutes - computed from expiry value.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-Keystring
Required

API Key for authentication. Provide your API key in the header.

Path Parameters

zoneidinteger
Required

Zone ID

Example:
42

Body

application/json
cachestring

Edge cache TTL duration code.

Allowed values:0s10s1m10m30m1h4h12h1d7d14d1M3M6M1y
expirystring

Browser cache TTL duration code. Same values as cache, or empty string to disable.

Example:
1d
querystringstring

Cache content per unique query string.

Allowed values:YN
cachecontrolstring

Honour Cache-Control headers from origin.

Allowed values:YN
usestalestring

Serve stale content while revalidating in the background.

Allowed values:YN
revalidatestring

Revalidate cached content on expiry.

Allowed values:YN
cacheInSecsnumber

Cache TTL in seconds - computed from cache value.

Example:
3600
cacheInMinsnumber

Cache TTL in minutes - computed from cache value.

Example:
60
expiryInSecsnumber

Browser cache TTL in seconds - computed from expiry value.

Example:
86400
expiryInMinsnumber

Browser cache TTL in minutes - computed from expiry value.

Example:
1440

Responses

resultstring

Status of the API response.

messagestring

Human-readable status message describing the outcome.

zoneobject