v1
latestOpenAPI 3.0.42026-07-26263457588.1 KBUpdate Pull Zone
Path parameters
The ID of the Pull Zone that should be updated
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)
Response
The Pull Zone was successfuly updated
The unique ID of the pull zone.
The name of the pull zone.
The origin URL of the pull zone where the files are fetched from.
True unless reached resource limits or account owning it ran out of funds.
The ID of the storage zone that the pull zone is linked to
The ID of the edge script that the pull zone is linked to
0 = Cache 1 = LoadBalancer
The ID of the Magic Container application the pull zone is linked to
The ID of the Magic Container Endpoint the pull zone is linked to
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
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
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 American region is enabled for this pull zone
Determines if the delivery from the European region is enabled for this pull zone
Determines if the delivery from the Asian / Oceanian region is enabled for this pull zone
Determines if the delivery from the South American region is enabled for this pull zone
Determines if the delivery from the Africa region is enabled for this pull zone
0 = IPv4Only 1 = DualStack 2 = DualStackPreferIPv6 3 = IPv6Only
True if the URL secure token authentication security is enabled
The security key used for secure URL token authentication
True if the zone security hash should include the remote IP
True if the Pull Zone is ignoring query strings when serving cached objects
The monthly limit of bandwidth in bytes that the pullzone is allowed to use
The amount of bandwidth in bytes that the pull zone used this month
The total monthly charges for this so zone so far
Determines if the Pull Zone should forward the current hostname to the origin
Determines the host header that will be sent to the origin
0 = Premium 1 = Volume
The list of extensions that will return the CORS headers
Determines if the CORS headers should be enabled
Determines if the cookies are disabled for the pull zone
The list of budget redirected countries with the two-letter Alpha2 ISO codes
The list of blocked countries with the two-letter Alpha2 ISO codes
If true the server will use the origin shield feature
The override cache time for the pull zone
The override cache time for the pull zone for the end client
Excessive requests are delayed until their number exceeds the maximum burst size.
Max number of requests per IP per second
If true, access to root path will return a 403 error
If true, POST requests to the zone will be blocked
The maximum rate at which the zone will transfer data in kb/s. 0 for unlimited
The amount of data after the rate limit will be activated
The number of connections limited per IP for this zone
The custom price override for this zone. Unit is $/Byte.
Monthly pricing for Bunny Optimizer for this pull zone
Determines if the Add Canonical Header is enabled for this Pull Zone
Determines if the logging is enabled for this Pull Zone
Determines if the cache slice (Optimize for video) feature is enabled for the Pull Zone
Determines if smart caching is enabled for this zone
Determines if the WebP Vary feature is enabled.
Determines if the AVIF Vary feature is enabled.
Determines if the Country Code Vary feature is enabled.
Determines if the Country State Code Vary feature should be enabled.
Determines if the Mobile Vary feature is enabled.
Determines if the Cookie Vary feature is enabled.
Contains the list of vary parameters that will be used for vary cache by cookie string. If empty, cookie vary will not be used.
Determines if the Hostname Vary feature is enabled.
The CNAME domain of the pull zone for setting up custom hostnames
Determines if the AWS Signing is enabled
The AWS Signing region key
The AWS Signing region secret
The AWS Signing region name
Determines if the TLS 1 is enabled on the Pull Zone
Determines if the TLS 1 is enabled on the Pull Zone
Determines if the TLS 1.1 is enabled on the Pull Zone
Determines if the Pull Zone should verify the origin SSL certificate
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
The zone code of the origin shield
Determines if the log forawrding is enabled
The log forwarding hostname
The log forwarding port
The log forwarding token value
0 = UDP 1 = TCP 2 = TCPEncrypted 3 = DataDog
Determines if the permanent logging feature is enabled
The ID of the logging storage zone that is configured for this Pull Zone
Determines if the zone will follow origin redirects
The ID of the video library that the zone is linked to
The ID of the DNS record tied to this pull zone
The ID of the DNS zone tied to this pull zone
The cached version of the DNS record value
Determines if the optimizer should be enabled for this zone
Determines if the optimizer origin tunnel system is 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 is 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
The IP of the storage zone used for Perma-Cache
0 = Automatic 1 = Manual
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.
Contains the list of vary parameters that will be used for vary cache by query string. 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 bunny.net should be caching error responses
Determines the max queue wait time
Determines the max number of origin requests that will remain in the queu
Determines if the optimizer class list should be enforced
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
Determines if cache update is performed in the background.
If set to true, any hostnames added to this Pull Zone will automatically enable SSL.
If set to true the query string ordering property is enabled.
0 = OneDigit 1 = Drop
0 = Plain 1 = JSON
0 = Plain 1 = JSON
0 = DetectOnly 1 = ActiveStandard 2 = ActiveAggressive
0 = OriginUrl 1 = DnsAccelerate 2 = StorageZone 3 = LoadBalancer 4 = EdgeScript 5 = MagicContainers 6 = PushZone
Determines if request coalescing is currently enabled.
Determines the lock time for coalesced requests.
Returns the link short preview value for the pull zone origin connection.
If true, the built-in let's encrypt is disabled and requests are passed to the origin.
Determines if the preloading screen is currently enabled
Determines if the preloading screen is shown on the first load from a user.
The custom preloading screen code
The preloading screen logo URL
Determines if the custom preloader screen is enabled
0 = Light 1 = Dark
The delay in miliseconds after which the preloading screen will be desplayed
The Pull Zone specific pricing discount for EU and US region.
The Pull Zone specific pricing discount for South America region.
The Pull Zone specific pricing discount for Africa region.
The Pull Zone specific pricing discount for Asia & Oceania region.
The list of routing filters enabled for this zone
Determines if direct access to files will be blocked if not coming from allowed referrers
0 = Off 1 = On
Sticky Session Cookie Name
A set of comma-separated header names used to identify clients
User Id of the pull zone owner
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.
Determines if extended logging with additional details is enabled for this Pull Zone.
Vary Cache by Request Headers (comma delimited)