v1
latestOpenAPI 3.0.42026-07-26263457588.1 KBAdd Pull Zone
Request body
Sets the origin URL of the Pull Zone
Sets the list of referrer hostnames that are allowed to access the pull zone. Requests containing the header Referer: hostname that is not on the list will be rejected. If empty, all the referrers are allowed
Sets the list of referrer hostnames that are blocked from accessing the pull zone.
Sets the list of IPs that are blocked from accessing the pull zone. Requests coming from the following IPs will be rejected. If empty, all the IPs will be allowed
Determines if the delivery from the North America region should be enabled for this pull zone
Determines if the delivery from the Europe region should be enabled for this pull zone
Determines if the delivery from the Asia / Oceania regions should be enabled for this pull zone
Determines if the delivery from the South America region should be enabled for this pull zone
Determines if the delivery from the Africa region should be enabled for this pull zone
0 = IPv4Only 1 = DualStack 2 = DualStackPreferIPv6 3 = IPv6Only
Determines if the zone should block requests to the root of the zone.
Determines if the POST requests to this zone should be rejected.
Determines if the query string ordering should be enabled.
Determines if the WebP Vary feature should be enabled.
Determines if the AVIF Vary feature should be enabled.
Determines if the Mobile Vary feature is enabled.
Determines if the Country Code Vary feature should be enabled.
Determines if the Country State Code Vary feature should be enabled.
Determines if the Hostname Vary feature should be enabled.
Determines if cache slicing (Optimize for video) should be enabled for this zone
Determines if the zone token authentication security should be enabled
Determines if the token authentication IP validation should be enabled
Determines if the Pull Zone should ignore query strings when serving cached objects (Vary by Query String)
Sets the monthly limit of bandwidth in bytes that the pullzone is allowed to use
Sets the list of extensions that will return the CORS headers
Determines if CORS headers should be enabled
Determines if the Pull Zone should automatically remove cookies from the responses
Sets the list of two letter Alpha2 country codes that will be redirected to the cheapest possible region
Sets the list of two letter Alpha2 country codes that will be blocked from accessing the zone
Sets the cache control override setting for this zone
Sets the browser cache control override setting for this zone
(Deprecated) Sets the browser cache control override setting for this zone
Determines if the zone should forward the requested host header to the origin
Determines if the canonical header should be added by this zone
Determines if the logging should be enabled for this zone
Determines if the log anonoymization should be enabled
The ID of the storage zone that should be used as the Perma-Cache
0 = Automatic 1 = Manual
Determines if the AWS signing should be enabled or not
Sets the AWS signing key
Sets the AWS signing region name
Sets the AWS signing secret key
Determines if the origin shield should be enabled
Determines the zone code where the origin shield should be set up
Determines if the TLS 1 should be enabled on this zone
Determines if the TLS 1.1 should be enabled on this zone
Determines if the cache error responses should be enabled on the zone
Determines if the SSL certificate should be verified when connecting to the origin
Sets the log forwarding token for the zone
Sets the log forwarding destination hostname for the zone
Sets the log forwarding port for the zone
Sets the log forwarding token for the zone
0 = UDP 1 = TCP 2 = TCPEncrypted 3 = DataDog
Determines if the logging permanent storage should be enabled
Sets the Storage Zone id that should contain the logs from this Pull Zone
Determines if the zone should follow redirects return by the oprigin and cache the response
Determines the maximum number of connections per IP that will be allowed to connect to this Pull Zone
Determines the maximum number of requests per second that will be allowed to connect to this Pull Zone
Determines the amount of traffic transferred before the client is limited
Determines the maximum number of requests per second coming from a single IP before it is blocked.
Determines the maximum burst requests before an IP is blocked
Determines if custom error page code should be enabled.
Contains the custom error page code that will be returned
Determines if the statuspage widget should be displayed on the error pages
The statuspage code that will be used to build the status widget
Determines if the error pages should be whitelabel or not
Determines if the optimizer should be enabled for this zone
Determines if the optimizer origin tunnel system should be enabled for this zone
Determines the maximum automatic image size for desktop clients
Determines the maximum automatic image size for mobile clients
Determines the image quality for desktop clients
Determines the image quality for mobile clients
Determines if the WebP optimization should be enabled
Determines if the SEO HTML prerender should be enabled
Determines the image manipulation should be enabled
Determines if the CSS minifcation should be enabled
Determines if the JavaScript minifcation should be enabled
Determines if image watermarking should be enabled
Sets the URL of the watermark image
0 = BottomLeft 1 = BottomRight 2 = TopLeft 3 = TopRight 4 = Center 5 = CenterStretch
Sets the offset of the watermark image
Sets the minimum image size to which the watermark will be added
Determines if the automatic image optimization should be enabled
Determines if the optimizer classes should be forced
Determines whether optimizer static html feature enabled
Wordpress html path which should be bypassed by permacache in edge rule
Wordpress cookie which should be bypassed by permacache in edge rule
0 = Premium 1 = Volume
The number of retries to the origin server
The amount of seconds to wait when connecting to the origin. Otherwise the request will fail or retry.
The amount of seconds to wait when waiting for the origin reply. Otherwise the request will fail or retry.
Determines if we should use stale cache while cache is updating
Determines if we should use stale cache while the origin is offline
Determines if we should retry the request in case of a 5XX response.
Determines if we should retry the request in case of a connection timeout.
Determines if we should retry the request in case of a response timeout.
Determines the amount of time that the CDN should wait before retrying an origin request.
Determines the origin port of the pull zone.
Determines the origin scheme of the pull zone.
Contains the list of vary parameters that will be used for vary cache by query string. Only alphanumeric characters, dashes and underscores are allowed (values that contain other characters are ignorred). If empty, all parameters will be used to construct the key.
Determines if the origin shield concurrency limit is enabled.
Determines the number of maximum concurrent requests allowed to the origin.
Determines if the Cookie Vary feature is enabled.
Contains the list of vary parameters that will be used for vary cache by cookie string.Only alphanumeric characters, dashes and underscores are allowed (values that contain other characters are ignorred). If empty, cookie vary will not be used.
Determines the max queue wait time
Determines the max number of origin requests that will remain in the queue
Determines if cache update is performed in the background.
If set to true, any hostnames added to this Pull Zone will automatically enable SSL.
0 = OneDigit 1 = Drop
The ID of the storage zone that will be used as the origin
The ID of the edge script that will be used as the origin
The ID of the middleware script
0 = Cache 1 = LoadBalancer
0 = OriginUrl 1 = DnsAccelerate 2 = StorageZone 3 = LoadBalancer 4 = EdgeScript 5 = MagicContainers 6 = PushZone
0 = Plain 1 = JSON
0 = Plain 1 = JSON
0 = DetectOnly 1 = ActiveStandard 2 = ActiveAggressive
Sets the host header that will be sent to the origin
Determines if request coalescing is currently enabled.
Determines the lock time for coalesced requests.
If set to true, the built-in let's encrypt will be disabled and requests are passed to the origin.
Determines if the preloading screen is currently enabled
The custom preloading screen coed
The preloading screen logo URL
Determines if the preloading screen is shown on the first load from a user.
0 = Light 1 = Dark
Determines if the custom preloader screen should be enabled
The delay in miliseconds after which the preloading screen will be displayed (0 - 10000ms)
The list of routing filters enabled for this zone
0 = Off 1 = On
Sticky Session Cookie Name
A set of comma-separated header names used to identify clients
Determines if Optimizer is allowed to upscale images
Determines if WebSocket connections are allowed for this Pull Zone.
The maximum global simultaneous WebSocket connections allowed for this Pull Zone. Allowed tiers: 500, 1,000, 2,500, 5,000, 10,000, 25,000. If you send a non-tier value, the value is rounded up to the next tier. Values over 25,000 are rejected, please contact sales if required.
Vary Cache by Request Headers (comma delimited)
The name of the pull zone.
Response
The Pull Zone was successfuly added