SecurityUpdate Secure Token

Update Secure Token

Update SecureToken of HTTP push zone

curl -X POST "https://api.5centscdn.com/v2/zones/http/push/42/securetoken" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "enabled": "Y",
  "policy": "Q",
  "keyip": "N",
  "list": "ab12cd34ef56gh78",
  "timeout": 3600,
  "session": "0",
  "ips": ""
}'
{
  "result": "success",
  "message": "Zone Updated",
  "zone": {
    "type": "push",
    "id": 12345,
    "serviceid": 67890,
    "alias": "my-cdn-zone",
    "hashid": "abc123def456",
    "mode": "http",
    "optimizer": "0",
    "cnames": "",
    "edgeruleids": 0,
    "rclone": 0,
    "disabled": "0",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-06-01T08:00:00Z",
    "deleted": null,
    "router": "mycdn",
    "remaining": 0,
    "status": "active",
    "name": "my-cdn-zone",
    "fqdn": "cdn.example.com",
    "ssl": {
      "http": "N",
      "http2": "Y",
      "redirect": "Y",
      "mode": "S",
      "certid": null,
      "zerossl": null,
      "enabled": "Y",
      "warning": false
    },
    "cnamesArr": [
      "cdn.example.com"
    ],
    "cnamesArrFqdn": [
      "cdn.example.com"
    ],
    "waf": {
      "enabled": "N"
    },
    "defaultBehaviors": {},
    "edgeRules": [],
    "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"
    },
    "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"
    },
    "ipaccess": {
      "enabled": "Y",
      "policy": "N",
      "list": "203.0.113.10,10.0.0.0/8",
      "ips": "",
      "active": "N"
    },
    "useragent": {
      "enabled": "Y",
      "policy": "N",
      "list": "*Chrome*;;;*Firefox*",
      "casesensitive": "N",
      "ips": "",
      "active": "N",
      "listArr": [
        "*Chrome*",
        "*Firefox*"
      ]
    },
    "securetoken": {
      "policy": "F",
      "keyip": "N",
      "list": "ab12cd34ef56gh78",
      "timeout": 3600,
      "session": "0",
      "ips": "",
      "dirs": "",
      "enabled": "N",
      "active": "N"
    },
    "bwlimit": {
      "enabled": "Y",
      "policy": 0,
      "rate": 0,
      "rateafter": 0
    },
    "eac": {
      "policy": "N",
      "list": "http://example.com/auth.script",
      "ips": "203.0.113.10",
      "enabled": "N",
      "active": "N"
    },
    "behaviorId": 11111,
    "linkedVideoManager": null,
    "hostHeader": "cdn.example.com",
    "storageHost": "storage.example.com",
    "storageHostBackup": "storage-eu.example.com",
    "osAuthUrl": "https://storage.example.com/v3/",
    "horizonUrl": "https://storage.example.com/horizon/",
    "cdnservice": {
      "purgeurls": [
        "/dashboard/67890/zones/http/push/12345/purge"
      ],
      "purgeurl": "["\\/dashboard\\/67890\\/zones\\/http\\/push\\/12345\\/purge"]",
      "authtoken": "c2FtcGxlLWF1dGh0b2tlbi1oZXJl",
      "infourl": "https://cdn-service.example.com/service.php/info/5/push/12345",
      "listurl": "https://cdn-service.example.com/service.php/list/5/push/12345",
      "rawlisturl": "https://cdn-service.example.com/service.php/raw/list/5/push/12345",
      "transcodelisturl": "https://cdn-service.example.com/service.php/transcode/list/5/push/12345",
      "addurl": "https://cdn-service.example.com/service.php/add/5/push/12345",
      "editurl": "https://cdn-service.example.com/service.php/edit/5/push/12345",
      "deleteurl": "https://cdn-service.example.com/service.php/delete/5/push/12345",
      "uploadurl": "https://cdn-service.example.com/upload.php",
      "playlisturl": "https://cdn-service.example.com/service.php/playlist"
    },
    "ftpdetails": {
      "username": "user_67890_push_12345",
      "password": "••••••••"
    },
    "playbackurls": {},
    "s3details": {
      "relid": 12345,
      "type": "push",
      "projectid": "abc123def456789012345678abcdef12",
      "token": "sample-access-token",
      "projectid2": "def456abc789012345678901abcdef34",
      "token2": "sample-access-token",
      "active": "1",
      "updated_at": "2024-06-01T08:00:00Z",
      "last_modified": ""
    },
    "transcodefile": {
      "profiles": [
        "1",
        "2"
      ],
      "emails": [
        "admin@example.com"
      ],
      "webhooks": [
        "https://hooks.example.com/webhook"
      ]
    },
    "server": {
      "code": "206",
      "name": "Singapore",
      "country": "SouthEast Asia",
      "meta": {
        "uploadPort": "21",
        "uploadHost": "upload.example.com"
      }
    },
    "hasEdgeRules": false
  }
}
POST
/zones/http/push/{zoneid}/securetoken
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
enabledstring

Enable or disable secure token.

Options: Y, N
policystring

Defines how the token is computed. Q = Query string mode (token applied per query string parameter). F = Full path mode (token covers the full URL path). D = Directory/path-embedded mode (token is embedded within the URL path).

Options: Q, F, D
keyipstring

Bind token validation to the originating client IP address. Y = token is only valid from the IP that generated it, preventing sharing or theft. N = IP binding is disabled.

Options: Y, N
liststring
Required

Secret token key - 16-character hexadecimal string.

Pattern: ^[a-fA-F0-9]{16}$
timeoutnumber

Token expiry time in seconds. Minimum 5, maximum 25200.

Min: 5 • Max: 25200
sessionstring

Defines the token expiry behavior. "0" = Fixed expiry (token expires at a set time). "1" = Rolling/Moving expiry (token timeout resets with each request for active sessions).

Options: 0, 1
ipsstring

Comma-separated IPs excluded from the secure token check.

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
enabledstring

Enable or disable secure token.

Allowed values:YN
policystring

Defines how the token is computed. Q = Query string mode (token applied per query string parameter). F = Full path mode (token covers the full URL path). D = Directory/path-embedded mode (token is embedded within the URL path).

Allowed values:QFD
keyipstring

Bind token validation to the originating client IP address. Y = token is only valid from the IP that generated it, preventing sharing or theft. N = IP binding is disabled.

Allowed values:YN
liststring
Required

Secret token key - 16-character hexadecimal string.

Example:
ab12cd34ef56gh78
timeoutnumber

Token expiry time in seconds. Minimum 5, maximum 25200.

Example:
3600
sessionstring

Defines the token expiry behavior. "0" = Fixed expiry (token expires at a set time). "1" = Rolling/Moving expiry (token timeout resets with each request for active sessions).

Allowed values:01
ipsstring

Comma-separated IPs excluded from the secure token check.

Example:

Responses

resultstring

Status of the API response.

messagestring

Human-readable status or result message

zoneobject