Skip to content
Start here

Zones

List Zones
zones.list(ZoneListParams**kwargs) -> SyncV4PagePaginationArray[Zone]
GET/zones
Zone Details
zones.get(ZoneGetParams**kwargs) -> Zone
GET/zones/{zone_id}
Create Zone
zones.create(ZoneCreateParams**kwargs) -> Zone
POST/zones
Edit Zone
zones.edit(ZoneEditParams**kwargs) -> Zone
PATCH/zones/{zone_id}
Delete Zone
zones.delete(ZoneDeleteParams**kwargs) -> ZoneDeleteResponse
DELETE/zones/{zone_id}
ModelsExpand Collapse
Literal["full", "partial", "secondary", "internal"]

A full zone implies that DNS is hosted with Cloudflare. A partial zone is typically a partner-hosted zone or a CNAME setup.

One of the following:
"full"
"partial"
"secondary"
"internal"
class Zone:
id: str

Identifier

maxLength32
account: Account

The account the zone belongs to.

id: Optional[str]

Identifier

maxLength32
name: Optional[str]

The name of the account.

activated_on: Optional[datetime]

The last time proof of ownership was detected and the zone was made active.

formatdate-time
created_on: datetime

When the zone was created.

formatdate-time
development_mode: float

The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is 0.

meta: Meta

Metadata about the zone.

cdn_only: Optional[bool]

The zone is only configured for CDN.

custom_certificate_quota: Optional[int]

Number of Custom Certificates the zone can have.

dns_only: Optional[bool]

The zone is only configured for DNS.

foundation_dns: Optional[bool]

The zone is setup with Foundation DNS.

page_rule_quota: Optional[int]

Number of Page Rules a zone can have.

phishing_detected: Optional[bool]

The zone has been flagged for phishing.

step: Optional[int]
modified_on: datetime

When the zone was last modified.

formatdate-time
name: str

The domain name. Per RFC 1035 the overall zone name can be up to 253 characters, with each segment ("label") not exceeding 63 characters.

maxLength253
name_servers: List[str]

The name servers Cloudflare assigns to a zone.

original_dnshost: Optional[str]

DNS host at the time of switching to Cloudflare.

maxLength50
original_name_servers: Optional[List[str]]

Original name servers before moving to Cloudflare.

original_registrar: Optional[str]

Registrar for the domain at the time of switching to Cloudflare.

owner: Owner

The owner of the zone.

id: Optional[str]

Identifier

maxLength32
name: Optional[str]

Name of the owner.

type: Optional[str]

The type of owner.

Deprecatedplan: Plan
Please use the `/zones/{zone_id}/subscription` API to update a zone's plan. Changing this value will create/cancel associated subscriptions. To view available plans for this zone, see [Zone Plans](https://developers.cloudflare.com/api/resources/zones/subresources/plans/).

A Zones subscription information.

id: Optional[str]

Identifier

maxLength32
can_subscribe: Optional[bool]

States if the subscription can be activated.

currency: Optional[str]

The denomination of the customer.

externally_managed: Optional[bool]

If this Zone is managed by another company.

frequency: Optional[str]

How often the customer is billed.

is_subscribed: Optional[bool]

States if the subscription active.

legacy_discount: Optional[bool]

If the legacy discount applies to this Zone.

legacy_id: Optional[str]

The legacy name of the plan.

name: Optional[str]

Name of the owner.

price: Optional[float]

How much the customer is paying.

cname_suffix: Optional[str]

Allows the customer to use a custom apex. Tenants Only Configuration.

paused: Optional[bool]

Indicates whether the zone is only using Cloudflare DNS services. A true value means the zone will not receive security or performance benefits.

Deprecatedpermissions: Optional[List[str]]
This has been replaced by Account memberships.

Legacy permissions based on legacy user membership information.

status: Optional[Literal["initializing", "pending", "active", "moved"]]

The zone status on Cloudflare.

One of the following:
"initializing"
"pending"
"active"
"moved"
tenant: Optional[Tenant]

The root organizational unit that this zone belongs to (such as a tenant or organization).

id: Optional[str]

Identifier

maxLength32
name: Optional[str]

The name of the Tenant account.

tenant_unit: Optional[TenantUnit]

The immediate parent organizational unit that this zone belongs to (such as under a tenant or sub-organization).

id: Optional[str]

Identifier

maxLength32
type: Optional[Type]

A full zone implies that DNS is hosted with Cloudflare. A partial zone is typically a partner-hosted zone or a CNAME setup.

vanity_name_servers: Optional[List[str]]

An array of domains used for custom name servers. This is only available for Business and Enterprise plans.

verification_key: Optional[str]

Verification key for partial zone setup.

class ZoneDeleteResponse:
id: str

Identifier

maxLength32

ZonesActivation Check

Rerun the Activation Check
zones.activation_check.trigger(ActivationCheckTriggerParams**kwargs) -> ActivationCheckTriggerResponse
PUT/zones/{zone_id}/activation_check
ModelsExpand Collapse
class ActivationCheckTriggerResponse:
id: Optional[str]

Identifier.

maxLength32

ZonesSettings

Get zone setting
zones.settings.get(strsetting_id, SettingGetParams**kwargs) -> SettingGetResponse
GET/zones/{zone_id}/settings/{setting_id}
Edit zone setting
zones.settings.edit(strsetting_id, SettingEditParams**kwargs) -> SettingEditResponse
PATCH/zones/{zone_id}/settings/{setting_id}
ModelsExpand Collapse
class AdvancedDDoS:

Advanced protection from Distributed Denial of Service (DDoS) attacks on your website. This is an uneditable value that is 'on' in the case of Business and Enterprise zones.

id: Literal["advanced_ddos"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class Aegis:

Aegis provides dedicated egress IPs (from Cloudflare to your origin) for your layer 7 WAF and CDN services. The egress IPs are reserved exclusively for your account so that you can increase your origin security by only allowing traffic from a small list of IP addresses.

id: Literal["aegis"]

ID of the zone setting.

modified_on: Optional[datetime]

Last time this setting was modified.

formatdate-time
value: Optional[Value]

Value of the zone setting.

enabled: Optional[bool]

Whether the feature is enabled or not.

pool_id: Optional[str]

Egress pool id which refers to a grouping of dedicated egress IPs through which Cloudflare will connect to origin.

class AlwaysOnline:

When enabled, Cloudflare serves limited copies of web pages available from the Internet Archive's Wayback Machine if your server is offline. Refer to Always Online for more information.

id: Literal["always_online"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class AlwaysUseHTTPS:
id: Optional[Literal["always_use_https"]]

If enabled, any http://`` URL is converted to https://` through a 301 redirect.

class AutomaticHTTPSRewrites:
id: Optional[Literal["automatic_https_rewrites"]]

Turn on or off Automatic HTTPS Rewrites.

value: Optional[Literal["on", "off"]]

The status of Automatic HTTPS Rewrites.

One of the following:
"on"
"off"
class AutomaticPlatformOptimization:
cache_by_device_type: bool

Indicates whether or not cache by device type is enabled.

cf: bool

Indicates whether or not Cloudflare proxy is enabled.

enabled: bool

Indicates whether or not Automatic Platform Optimization is enabled.

hostnames: List[str]

An array of hostnames where Automatic Platform Optimization for WordPress is activated.

wordpress: bool

Indicates whether or not site is powered by WordPress.

wp_plugin: bool

Indicates whether or not Cloudflare for WordPress plugin is installed.

class Brotli:

When the client requesting an asset supports the Brotli compression algorithm, Cloudflare will serve a Brotli compressed version of the asset.

id: Literal["brotli"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class BrowserCacheTTL:
id: Optional[Literal["browser_cache_ttl"]]

Control how long resources cached by client browsers remain valid.

value: Optional[int]

The number of seconds to cache resources for. Setting this to 0 enables "Respect Existing Headers".

maximum31536000
minimum0
class BrowserCheck:
id: Optional[Literal["browser_check"]]

Inspect the visitor's browser for headers commonly associated with spammers and certain bots.

value: Optional[Literal["on", "off"]]

The status of Browser Integrity Check.

One of the following:
"on"
"off"
class CacheLevel:
id: Optional[Literal["cache_level"]]

Apply custom caching based on the option selected.

value: Optional[Literal["bypass", "basic", "simplified", 2 more]]
  • bypass: Cloudflare does not cache.
  • basic: Delivers resources from cache when there is no query string.
  • simplified: Delivers the same resource to everyone independent of the query string.
  • aggressive: Caches all static content that has a query string.
  • cache_everything: Treats all content as static and caches all file types beyond the Cloudflare default cached content.
One of the following:
"bypass"
"basic"
"simplified"
"aggressive"
"cache_everything"
class ChallengeTTL:

Specify how long a visitor is allowed access to your site after successfully completing a challenge (such as a CAPTCHA). After the TTL has expired the visitor will have to complete a new challenge. We recommend a 15 - 45 minute setting and will attempt to honor any setting above 45 minutes. (https://support.cloudflare.com/hc/en-us/articles/200170136).

id: Literal["challenge_ttl"]

ID of the zone setting.

value: Literal[300, 900, 1800, 11 more]

Current value of the zone setting.

One of the following:
300
900
1800
2700
3600
7200
10800
14400
28800
57600
86400
604800
2592000
31536000
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class Ciphers:

An allowlist of ciphers for TLS termination. These ciphers must be in the BoringSSL format.

id: Literal["ciphers"]

ID of the zone setting.

value: List[str]

Current value of the zone setting.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class DevelopmentMode:

Development Mode temporarily allows you to enter development mode for your websites if you need to make changes to your site. This will bypass Cloudflare's accelerated cache and slow down your site, but is useful if you are making changes to cacheable content (like images, css, or JavaScript) and would like to see those changes right away. Once entered, development mode will last for 3 hours and then automatically toggle off.

id: Literal["development_mode"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
time_remaining: Optional[float]

Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.

class EarlyHints:

When enabled, Cloudflare will attempt to speed up overall page loads by serving 103 responses with Link headers from the final response. Refer to Early Hints for more information.

id: Literal["early_hints"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class EmailObfuscation:
id: Optional[Literal["email_obfuscation"]]

Turn on or off Email Obfuscation.

value: Optional[Literal["on", "off"]]

The status of Email Obfuscation.

One of the following:
"on"
"off"
class FontSettings:

Enhance your website's font delivery with Cloudflare Fonts. Deliver Google Hosted fonts from your own domain, boost performance, and enhance user privacy. Refer to the Cloudflare Fonts documentation for more information.

id: Optional[Literal["fonts"]]

ID of the zone setting.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
value: Optional[Literal["on", "off"]]

Current value of the zone setting.

One of the following:
"on"
"off"
class H2Prioritization:

HTTP/2 Edge Prioritization optimises the delivery of resources served through HTTP/2 to improve page load performance. It also supports fine control of content delivery when used in conjunction with Workers.

id: Literal["h2_prioritization"]

ID of the zone setting.

value: Literal["on", "off", "custom"]

Current value of the zone setting.

One of the following:
"on"
"off"
"custom"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
One of the following:
One of the following:
class HTTP2:

HTTP2 enabled for this zone.

id: Literal["http2"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class HTTP3:

HTTP3 enabled for this zone.

id: Literal["http3"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ImageResizing:

Image Transformations provides on-demand resizing, conversion and optimization for images served through Cloudflare's network. Refer to the Image Transformations documentation for more information.

id: Literal["image_resizing"]

ID of the zone setting.

value: Literal["on", "off", "open"]

Current value of the zone setting.

One of the following:
"on"
"off"
"open"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class IPGeolocation:
id: Optional[Literal["ip_geolocation"]]

Cloudflare adds a CF-IPCountry HTTP header containing the country code that corresponds to the visitor.

value: Optional[Literal["on", "off"]]

The status of adding the IP Geolocation Header.

One of the following:
"on"
"off"
class IPV6:

Enable IPv6 on all subdomains that are Cloudflare enabled. (https://support.cloudflare.com/hc/en-us/articles/200168586).

id: Literal["ipv6"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class MinTLSVersion:

Only accepts HTTPS requests that use at least the TLS protocol version specified. For example, if TLS 1.1 is selected, TLS 1.0 connections will be rejected, while 1.1, 1.2, and 1.3 (if enabled) will be permitted.

id: Literal["min_tls_version"]

ID of the zone setting.

value: Literal["1.0", "1.1", "1.2", "1.3"]

Current value of the zone setting.

One of the following:
"1.0"
"1.1"
"1.2"
"1.3"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class Mirage:
id: Optional[Literal["mirage"]]

Cloudflare Mirage reduces bandwidth used by images in mobile browsers. It can accelerate loading of image-heavy websites on very slow mobile connections and HTTP/1.

value: Optional[Literal["on", "off"]]

The status of Mirage.

One of the following:
"on"
"off"
class NEL:

Enable Network Error Logging reporting on your zone. (Beta)

id: Literal["nel"]

Zone setting identifier.

value: Value

Current value of the zone setting.

enabled: Optional[bool]
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class OpportunisticEncryption:
id: Optional[Literal["opportunistic_encryption"]]

Opportunistic Encryption allows browsers to access HTTP URIs over an encrypted TLS channel. It's not a substitute for HTTPS, but provides additional security for otherwise vulnerable requests.

value: Optional[Literal["on", "off"]]

The status of Opportunistic Encryption.

One of the following:
"on"
"off"
class OpportunisticOnion:

Add an Alt-Svc header to all legitimate requests from Tor, allowing the connection to use our onion services instead of exit nodes.

id: Literal["opportunistic_onion"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class OrangeToOrange:

Orange to Orange (O2O) allows zones on Cloudflare to CNAME to other zones also on Cloudflare.

id: Literal["orange_to_orange"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class OriginErrorPagePassThru:
id: Optional[Literal["origin_error_page_pass_thru"]]

Turn on or off Cloudflare error pages generated from issues sent from the origin server. If enabled, this setting triggers error pages issued by the origin.

value: Optional[Literal["on", "off"]]

The status of Origin Error Page Passthru.

One of the following:
"on"
"off"
class OriginMaxHTTPVersion:
id: Literal["origin_max_http_version"]

The identifier of the caching setting.

editable: bool

Whether the setting is editable.

value: Literal["2", "1"]

Value of the Origin Max HTTP Version Setting.

One of the following:
"2"
"1"
modified_on: Optional[datetime]

Last time this setting was modified.

formatdate-time
class Polish:
id: Optional[Literal["polish"]]

Apply options from the Polish feature of the Cloudflare Speed app.

value: Optional[Literal["off", "lossless", "lossy"]]

The level of Polish you want applied to your origin.

One of the following:
"off"
"lossless"
"lossy"
class PrefetchPreload:

Cloudflare will prefetch any URLs that are included in the response headers. This is limited to Enterprise Zones.

id: Literal["prefetch_preload"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ProxyReadTimeout:

Maximum time between two read operations from origin.

id: Literal["proxy_read_timeout"]

ID of the zone setting.

value: float

Current value of the zone setting.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class PseudoIPV4:

The value set for the Pseudo IPv4 setting.

id: Literal["pseudo_ipv4"]

Value of the Pseudo IPv4 setting.

value: Literal["off", "add_header", "overwrite_header"]

Current value of the zone setting.

One of the following:
"off"
"add_header"
"overwrite_header"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ResponseBuffering:
id: Optional[Literal["response_buffering"]]

Turn on or off whether Cloudflare should wait for an entire file from the origin server before forwarding it to the site visitor. By default, Cloudflare sends packets to the client as they arrive from the origin server.

value: Optional[Literal["on", "off"]]

The status of Response Buffering

One of the following:
"on"
"off"
class RocketLoader:
id: Optional[Literal["rocket_loader"]]

Turn on or off Rocket Loader in the Cloudflare Speed app.

value: Optional[Literal["on", "off"]]

The status of Rocket Loader

One of the following:
"on"
"off"
class SecurityHeaders:

Cloudflare security header for a zone.

id: Literal["security_header"]

ID of the zone's security header.

value: Value

Current value of the zone setting.

strict_transport_security: Optional[ValueStrictTransportSecurity]

Strict Transport Security.

enabled: Optional[bool]

Whether or not strict transport security is enabled.

include_subdomains: Optional[bool]

Include all subdomains for strict transport security.

max_age: Optional[float]

Max age in seconds of the strict transport security.

nosniff: Optional[bool]

Whether or not to include 'X-Content-Type-Options: nosniff' header.

preload: Optional[bool]

Enable automatic preload of the HSTS configuration.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class SecurityLevel:
id: Optional[Literal["security_level"]]

Control options for the Security Level feature from the Security app.

value: Optional[Literal["off", "essentially_off", "low", 3 more]]
One of the following:
"off"
"essentially_off"
"low"
"medium"
"high"
"under_attack"
class ServerSideExcludes:

If there is sensitive content on your website that you want visible to real visitors, but that you want to hide from suspicious visitors, all you have to do is wrap the content with Cloudflare SSE tags. Wrap any content that you want to be excluded from suspicious visitors in the following SSE tags: . For example: Bad visitors won't see my phone number, 555-555-5555 . Note: SSE only will work with HTML. If you have HTML minification enabled, you won't see the SSE tags in your HTML source when it's served through Cloudflare. SSE will still function in this case, as Cloudflare's HTML minification and SSE functionality occur on-the-fly as the resource moves through our network to the visitor's computer. (https://support.cloudflare.com/hc/en-us/articles/200170036).

id: Literal["server_side_exclude"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class SortQueryStringForCache:
id: Optional[Literal["sort_query_string_for_cache"]]

Turn on or off the reordering of query strings. When query strings have the same structure, caching improves.

value: Optional[Literal["on", "off"]]

The status of Query String Sort

One of the following:
"on"
"off"
class SSL:
id: Optional[Literal["ssl"]]

Control options for the SSL feature of the Edge Certificates tab in the Cloudflare SSL/TLS app.

value: Optional[Literal["off", "flexible", "full", 2 more]]

The encryption mode that Cloudflare uses to connect to your origin server.

One of the following:
"off"
"flexible"
"full"
"strict"
"origin_pull"
class SSLRecommender:

Enrollment in the SSL/TLS Recommender service which tries to detect and recommend (by sending periodic emails) the most secure SSL/TLS setting your origin servers support.

id: Optional[Literal["ssl_recommender"]]

Enrollment value for SSL/TLS Recommender.

enabled: Optional[bool]

ssl-recommender enrollment setting.

class TLS1_3:

Enables Crypto TLS 1.3 feature for a zone.

id: Literal["tls_1_3"]

ID of the zone setting.

value: Literal["on", "off", "zrt"]

Current value of the zone setting.

One of the following:
"on"
"off"
"zrt"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class TLSClientAuth:

TLS Client Auth requires Cloudflare to connect to your origin server using a client certificate (Enterprise Only).

id: Literal["tls_client_auth"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class TrueClientIPHeader:
id: Optional[Literal["true_client_ip_header"]]

Turn on or off the True-Client-IP Header feature of the Cloudflare Network app.

value: Optional[Literal["on", "off"]]

The status of True Client IP Header.

One of the following:
"on"
"off"
class WAF:
id: Optional[Literal["waf"]]

Turn on or off WAF managed rules (previous version, deprecated). You cannot enable or disable individual WAF managed rules via Page Rules.

value: Optional[Literal["on", "off"]]

The status of WAF managed rules (previous version).

One of the following:
"on"
"off"
class WebP:

When the client requesting the image supports the WebP image codec, and WebP offers a performance advantage over the original image format, Cloudflare will serve a WebP version of the original image.

id: Literal["webp"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class Websocket:

WebSockets are open connections sustained between the client and the origin server. Inside a WebSockets connection, the client and the origin can pass data back and forth without having to reestablish sessions. This makes exchanging data within a WebSockets connection fast. WebSockets are often used for real-time applications such as live chat and gaming. For more information refer to Can I use Cloudflare with Websockets.

id: Literal["websockets"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZeroRTT:

0-RTT session resumption enabled for this zone.

id: Literal["0rtt"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time

0-RTT session resumption enabled for this zone.

One of the following:
class ZeroRTT:

0-RTT session resumption enabled for this zone.

id: Literal["0rtt"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class AdvancedDDoS:

Advanced protection from Distributed Denial of Service (DDoS) attacks on your website. This is an uneditable value that is 'on' in the case of Business and Enterprise zones.

id: Literal["advanced_ddos"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesCacheRulesAegis:

Aegis provides dedicated egress IPs (from Cloudflare to your origin) for your layer 7 WAF and CDN services. The egress IPs are reserved exclusively for your account so that you can increase your origin security by only allowing traffic from a small list of IP addresses.

id: Literal["aegis"]

ID of the zone setting.

modified_on: Optional[datetime]

Last time this setting was modified.

formatdate-time
value: Optional[ZonesCacheRulesAegisValue]

Value of the zone setting.

enabled: Optional[bool]

Whether the feature is enabled or not.

pool_id: Optional[str]

Egress pool id which refers to a grouping of dedicated egress IPs through which Cloudflare will connect to origin.

class AlwaysOnline:

When enabled, Cloudflare serves limited copies of web pages available from the Internet Archive's Wayback Machine if your server is offline. Refer to Always Online for more information.

id: Literal["always_online"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasAlwaysUseHTTPS:

Reply to all requests for URLs that use "http" with a 301 redirect to the equivalent "https" URL. If you only want to redirect for a subset of requests, consider creating an "Always use HTTPS" page rule.

id: Literal["always_use_https"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasAutomaticHTTPSRewrites:

Enable the Automatic HTTPS Rewrites feature for this zone.

id: Literal["automatic_https_rewrites"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class Brotli:

When the client requesting an asset supports the Brotli compression algorithm, Cloudflare will serve a Brotli compressed version of the asset.

id: Literal["brotli"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasBrowserCacheTTL:

Browser Cache TTL (in seconds) specifies how long Cloudflare-cached resources will remain on your visitors' computers. Cloudflare will honor any larger times specified by your server. (https://support.cloudflare.com/hc/en-us/articles/200168276).

id: Literal["browser_cache_ttl"]

ID of the zone setting.

value: int

Current value of the zone setting.

maximum31536000
minimum0
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasBrowserCheck:

Browser Integrity Check is similar to Bad Behavior and looks for common HTTP headers abused most commonly by spammers and denies access to your page. It will also challenge visitors that do not have a user agent or a non standard user agent (also commonly used by abuse bots, crawlers or visitors). (https://support.cloudflare.com/hc/en-us/articles/200170086).

id: Literal["browser_check"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasCacheLevel:

Cache Level functions based off the setting level. The basic setting will cache most static resources (i.e., css, images, and JavaScript). The simplified setting will ignore the query string when delivering a cached resource. The aggressive setting will cache all static resources, including ones with a query string. (https://support.cloudflare.com/hc/en-us/articles/200168256).

id: Literal["cache_level"]

ID of the zone setting.

value: Literal["aggressive", "basic", "simplified"]

Current value of the zone setting.

One of the following:
"aggressive"
"basic"
"simplified"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ChallengeTTL:

Specify how long a visitor is allowed access to your site after successfully completing a challenge (such as a CAPTCHA). After the TTL has expired the visitor will have to complete a new challenge. We recommend a 15 - 45 minute setting and will attempt to honor any setting above 45 minutes. (https://support.cloudflare.com/hc/en-us/articles/200170136).

id: Literal["challenge_ttl"]

ID of the zone setting.

value: Literal[300, 900, 1800, 11 more]

Current value of the zone setting.

One of the following:
300
900
1800
2700
3600
7200
10800
14400
28800
57600
86400
604800
2592000
31536000
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesChinaNetworkEnabled:

Determines whether or not the china network is enabled.

id: Literal["china_network_enabled"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesContentConverter:

When enabled and the client sends an Accept header requesting text/markdown, Cloudflare will convert HTML responses to Markdown format using the toMarkdown() service. Refer to the developer documentation for more information.

id: Literal["content_converter"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class Ciphers:

An allowlist of ciphers for TLS termination. These ciphers must be in the BoringSSL format.

id: Literal["ciphers"]

ID of the zone setting.

value: List[str]

Current value of the zone setting.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesCNAMEFlattening:

Whether or not cname flattening is on.

id: Literal["cname_flattening"]

How to flatten the cname destination.

Deprecatedvalue: Literal["flatten_at_root", "flatten_all"]
This zone setting is deprecated; please use the DNS Settings route instead. More information at https://developers.cloudflare.com/fundamentals/api/reference/deprecations/#2025-03-21

Current value of the zone setting.

One of the following:
"flatten_at_root"
"flatten_all"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class DevelopmentMode:

Development Mode temporarily allows you to enter development mode for your websites if you need to make changes to your site. This will bypass Cloudflare's accelerated cache and slow down your site, but is useful if you are making changes to cacheable content (like images, css, or JavaScript) and would like to see those changes right away. Once entered, development mode will last for 3 hours and then automatically toggle off.

id: Literal["development_mode"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
time_remaining: Optional[float]

Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.

class EarlyHints:

When enabled, Cloudflare will attempt to speed up overall page loads by serving 103 responses with Link headers from the final response. Refer to Early Hints for more information.

id: Literal["early_hints"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasEdgeCacheTTL:

Time (in seconds) that a resource will be ensured to remain on Cloudflare's cache servers.

id: Literal["edge_cache_ttl"]

ID of the zone setting.

value: Literal[30, 60, 300, 18 more]

Current value of the zone setting.

One of the following:
30
60
300
1200
1800
3600
7200
10800
14400
18000
28800
43200
57600
72000
86400
172800
259200
345600
432000
518400
604800
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasEmailObfuscation:

Encrypt email adresses on your web page from bots, while keeping them visible to humans. (https://support.cloudflare.com/hc/en-us/articles/200170016).

id: Literal["email_obfuscation"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class H2Prioritization:

HTTP/2 Edge Prioritization optimises the delivery of resources served through HTTP/2 to improve page load performance. It also supports fine control of content delivery when used in conjunction with Workers.

id: Literal["h2_prioritization"]

ID of the zone setting.

value: Literal["on", "off", "custom"]

Current value of the zone setting.

One of the following:
"on"
"off"
"custom"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
One of the following:
One of the following:
class HTTP2:

HTTP2 enabled for this zone.

id: Literal["http2"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class HTTP3:

HTTP3 enabled for this zone.

id: Literal["http3"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ImageResizing:

Image Transformations provides on-demand resizing, conversion and optimization for images served through Cloudflare's network. Refer to the Image Transformations documentation for more information.

id: Literal["image_resizing"]

ID of the zone setting.

value: Literal["on", "off", "open"]

Current value of the zone setting.

One of the following:
"on"
"off"
"open"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasIPGeolocation:

Enable IP Geolocation to have Cloudflare geolocate visitors to your website and pass the country code to you. (https://support.cloudflare.com/hc/en-us/articles/200168236).

id: Literal["ip_geolocation"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class IPV6:

Enable IPv6 on all subdomains that are Cloudflare enabled. (https://support.cloudflare.com/hc/en-us/articles/200168586).

id: Literal["ipv6"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesMaxUpload:

Maximum size of an allowable upload.

id: Literal["max_upload"]

identifier of the zone setting.

value: Literal[100, 125, 150, 15 more]

Current value of the zone setting.

One of the following:
100
125
150
175
200
225
250
275
300
325
350
375
400
425
450
475
500
1000
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class MinTLSVersion:

Only accepts HTTPS requests that use at least the TLS protocol version specified. For example, if TLS 1.1 is selected, TLS 1.0 connections will be rejected, while 1.1, 1.2, and 1.3 (if enabled) will be permitted.

id: Literal["min_tls_version"]

ID of the zone setting.

value: Literal["1.0", "1.1", "1.2", "1.3"]

Current value of the zone setting.

One of the following:
"1.0"
"1.1"
"1.2"
"1.3"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasMirage:

Automatically optimize image loading for website visitors on mobile devices. Refer to our blog post for more information.

id: Literal["mirage"]

ID of the zone setting.

Deprecatedvalue: Literal["on", "off"]
Mirage is being deprecated. More information at https://developers.cloudflare.com/speed/optimization/images/mirage/

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class NEL:

Enable Network Error Logging reporting on your zone. (Beta)

id: Literal["nel"]

Zone setting identifier.

value: Value

Current value of the zone setting.

enabled: Optional[bool]
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasOpportunisticEncryption:

Enables the Opportunistic Encryption feature for a zone.

id: Literal["opportunistic_encryption"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class OpportunisticOnion:

Add an Alt-Svc header to all legitimate requests from Tor, allowing the connection to use our onion services instead of exit nodes.

id: Literal["opportunistic_onion"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class OrangeToOrange:

Orange to Orange (O2O) allows zones on Cloudflare to CNAME to other zones also on Cloudflare.

id: Literal["orange_to_orange"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasOriginErrorPagePassThru:

Cloudflare will proxy customer error pages on any 502,504 errors on origin server instead of showing a default Cloudflare error page. This does not apply to 522 errors and is limited to Enterprise Zones.

id: Literal["origin_error_page_pass_thru"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesCacheRulesOriginH2MaxStreams:

Origin H2 Max Streams configures the max number of concurrent requests that Cloudflare will send within the same connection when communicating with the origin server, if the origin supports it. Note that if your origin does not support H2 multiplexing, 5xx errors may be observed, particularly 520s. Also note that the default value is 100 for all plan types except Enterprise where it is 1. 1 means that H2 multiplexing is disabled.

id: Literal["origin_h2_max_streams"]

Value of the zone setting.

modified_on: Optional[datetime]

Last time this setting was modified.

formatdate-time
value: Optional[int]

Value of the Origin H2 Max Streams Setting.

maximum1000
minimum1
class ZonesCacheRulesOriginMaxHTTPVersion:

Origin Max HTTP Setting Version sets the highest HTTP version Cloudflare will attempt to use with your origin. This setting allows Cloudflare to make HTTP/2 requests to your origin. (Refer to Enable HTTP/2 to Origin, for more information.). The default value is "2" for all plan types except Enterprise where it is "1".

id: Literal["origin_max_http_version"]

Value of the zone setting.

modified_on: Optional[datetime]

Last time this setting was modified.

formatdate-time
value: Optional[Literal["2", "1"]]

Value of the Origin Max HTTP Version Setting.

One of the following:
"2"
"1"
class ZonesSchemasPolish:

Removes metadata and compresses your images for faster page load times. Basic (Lossless): Reduce the size of PNG, JPEG, and GIF files - no impact on visual quality. Basic + JPEG (Lossy): Further reduce the size of JPEG files for faster image loading. Larger JPEGs are converted to progressive images, loading a lower-resolution image first and ending in a higher-resolution version. Not recommended for hi-res photography sites.

id: Literal["polish"]

ID of the zone setting.

value: Literal["off", "lossless", "lossy"]

Current value of the zone setting.

One of the following:
"off"
"lossless"
"lossy"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class PrefetchPreload:

Cloudflare will prefetch any URLs that are included in the response headers. This is limited to Enterprise Zones.

id: Literal["prefetch_preload"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesPrivacyPass:

Privacy Pass v1 was a browser extension developed by the Privacy Pass Team to improve the browsing experience for your visitors by allowing users to reduce the number of CAPTCHAs shown. (https://support.cloudflare.com/hc/en-us/articles/115001992652-Privacy-Pass).

id: Literal["privacy_pass"]

ID of the zone setting.

Deprecatedvalue: Literal["on", "off"]
Privacy Pass v1 was deprecated in 2023. (Announcement - https://blog.cloudflare.com/privacy-pass-standard/) and (API deprecation details - https://developers.cloudflare.com/fundamentals/api/reference/deprecations/#2024-03-31)

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ProxyReadTimeout:

Maximum time between two read operations from origin.

id: Literal["proxy_read_timeout"]

ID of the zone setting.

value: float

Current value of the zone setting.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class PseudoIPV4:

The value set for the Pseudo IPv4 setting.

id: Literal["pseudo_ipv4"]

Value of the Pseudo IPv4 setting.

value: Literal["off", "add_header", "overwrite_header"]

Current value of the zone setting.

One of the following:
"off"
"add_header"
"overwrite_header"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesRedirectsForAITraining:

When enabled, Cloudflare will redirect verified AI training crawlers to canonical URLs found in the HTML response, ensuring AI models train on authoritative content.

id: Literal["redirects_for_ai_training"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesReplaceInsecureJS:

Automatically replace insecure JavaScript libraries with safer and faster alternatives provided under cdnjs and powered by Cloudflare. Currently supports the following libraries: Polyfill under polyfill.io.

id: Literal["replace_insecure_js"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasResponseBuffering:

Enables or disables buffering of responses from the proxied server. Cloudflare may buffer the whole payload to deliver it at once to the client versus allowing it to be delivered in chunks. By default, the proxied server streams directly and is not buffered by Cloudflare. This is limited to Enterprise Zones.

id: Literal["response_buffering"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasRocketLoader:

Rocket Loader is a general-purpose asynchronous JavaScript optimisation that prioritises rendering your content while loading your site's Javascript asynchronously. Turning on Rocket Loader will immediately improve a web page's rendering time sometimes measured as Time to First Paint (TTFP), and also the window.onload time (assuming there is JavaScript on the page). This can have a positive impact on your Google search ranking. When turned on, Rocket Loader will automatically defer the loading of all Javascript referenced in your HTML, with no configuration required. Refer to Understanding Rocket Loader for more information.

id: Literal["rocket_loader"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasAutomaticPlatformOptimization:

Automatic Platform Optimization for WordPress serves your WordPress site from Cloudflare's edge network and caches third-party fonts.

id: Literal["automatic_platform_optimization"]

ID of the zone setting.

Current value of the zone setting.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class SecurityHeaders:

Cloudflare security header for a zone.

id: Literal["security_header"]

ID of the zone's security header.

value: Value

Current value of the zone setting.

strict_transport_security: Optional[ValueStrictTransportSecurity]

Strict Transport Security.

enabled: Optional[bool]

Whether or not strict transport security is enabled.

include_subdomains: Optional[bool]

Include all subdomains for strict transport security.

max_age: Optional[float]

Max age in seconds of the strict transport security.

nosniff: Optional[bool]

Whether or not to include 'X-Content-Type-Options: nosniff' header.

preload: Optional[bool]

Enable automatic preload of the HSTS configuration.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasSecurityLevel:

Choose the appropriate security profile for your website, which will automatically adjust each of the security settings. If you choose to customize an individual security setting, the profile will become Custom. (https://support.cloudflare.com/hc/en-us/articles/200170056).

id: Literal["security_level"]

ID of the zone setting.

value: Literal["off", "essentially_off", "low", 3 more]

Current value of the zone setting.

One of the following:
"off"
"essentially_off"
"low"
"medium"
"high"
"under_attack"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ServerSideExcludes:

If there is sensitive content on your website that you want visible to real visitors, but that you want to hide from suspicious visitors, all you have to do is wrap the content with Cloudflare SSE tags. Wrap any content that you want to be excluded from suspicious visitors in the following SSE tags: . For example: Bad visitors won't see my phone number, 555-555-5555 . Note: SSE only will work with HTML. If you have HTML minification enabled, you won't see the SSE tags in your HTML source when it's served through Cloudflare. SSE will still function in this case, as Cloudflare's HTML minification and SSE functionality occur on-the-fly as the resource moves through our network to the visitor's computer. (https://support.cloudflare.com/hc/en-us/articles/200170036).

id: Literal["server_side_exclude"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSha1Support:

Allow SHA1 support.

id: Literal["sha1_support"]

Zone setting identifier.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasSortQueryStringForCache:

Cloudflare will treat files with the same query strings as the same file in cache, regardless of the order of the query strings. This is limited to Enterprise Zones.

id: Literal["sort_query_string_for_cache"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasSSL:

SSL encrypts your visitor's connection and safeguards credit card numbers and other personal data to and from your website. SSL can take up to 5 minutes to fully activate. Requires Cloudflare active on your root domain or www domain. Off: no SSL between the visitor and Cloudflare, and no SSL between Cloudflare and your web server (all HTTP traffic). Flexible: SSL between the visitor and Cloudflare -- visitor sees HTTPS on your site, but no SSL between Cloudflare and your web server. You don't need to have an SSL cert on your web server, but your vistors will still see the site as being HTTPS enabled. Full: SSL between the visitor and Cloudflare -- visitor sees HTTPS on your site, and SSL between Cloudflare and your web server. You'll need to have your own SSL cert or self-signed cert at the very least. Full (Strict): SSL between the visitor and Cloudflare -- visitor sees HTTPS on your site, and SSL between Cloudflare and your web server. You'll need to have a valid SSL certificate installed on your web server. This certificate must be signed by a certificate authority, have an expiration date in the future, and respond for the request domain name (hostname). (https://support.cloudflare.com/hc/en-us/articles/200170416).

id: Literal["ssl"]

ID of the zone setting.

value: Literal["off", "flexible", "full", "strict"]

Current value of the zone setting.

One of the following:
"off"
"flexible"
"full"
"strict"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class SSLRecommender:

Enrollment in the SSL/TLS Recommender service which tries to detect and recommend (by sending periodic emails) the most secure SSL/TLS setting your origin servers support.

id: Optional[Literal["ssl_recommender"]]

Enrollment value for SSL/TLS Recommender.

enabled: Optional[bool]

ssl-recommender enrollment setting.

class ZonesTLS1_2Only:

Only allows TLS1.2.

id: Literal["tls_1_2_only"]

Zone setting identifier.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class TLS1_3:

Enables Crypto TLS 1.3 feature for a zone.

id: Literal["tls_1_3"]

ID of the zone setting.

value: Literal["on", "off", "zrt"]

Current value of the zone setting.

One of the following:
"on"
"off"
"zrt"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class TLSClientAuth:

TLS Client Auth requires Cloudflare to connect to your origin server using a client certificate (Enterprise Only).

id: Literal["tls_client_auth"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesTransformations:

Media Transformations provides on-demand resizing, conversion and optimization for images and video served through Cloudflare's network. Refer to the Image Transformations and Video Transformations documentation for more information.

id: Literal["transformations"]

ID of the zone setting. Shared between Image Transformations and Video Transformations.

value: Literal["on", "off", "open"]

Current value of the zone setting.

One of the following:
"on"
"off"
"open"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesTransformationsAllowedOrigins:

Media Transformations Allowed Origins restricts transformations for images and video served through Cloudflare's network. Refer to the Image Transformations and Video Transformations documentation for more information.

id: Literal["transformations_allowed_origins"]

ID of the zone setting. Shared between Image Transformations and Video Transformations.

value: str

Current value of the zone setting.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasTrueClientIPHeader:

Allows customer to continue to use True Client IP (Akamai feature) in the headers we send to the origin. This is limited to Enterprise Zones.

id: Literal["true_client_ip_header"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasWAF:

The WAF examines HTTP requests to your website. It inspects both GET and POST requests and applies rules to help filter out illegitimate traffic from legitimate website visitors. The Cloudflare WAF inspects website addresses or URLs to detect anything out of the ordinary. If the Cloudflare WAF determines suspicious user behavior, then the WAF will 'challenge' the web visitor with a page that asks them to submit a CAPTCHA successfully to continue their action. If the challenge is failed, the action will be stopped. What this means is that Cloudflare's WAF will block any traffic identified as illegitimate before it reaches your origin web server. (https://support.cloudflare.com/hc/en-us/articles/200172016).

id: Literal["waf"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class WebP:

When the client requesting the image supports the WebP image codec, and WebP offers a performance advantage over the original image format, Cloudflare will serve a WebP version of the original image.

id: Literal["webp"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class Websocket:

WebSockets are open connections sustained between the client and the origin server. Inside a WebSockets connection, the client and the origin can pass data back and forth without having to reestablish sessions. This makes exchanging data within a WebSockets connection fast. WebSockets are often used for real-time applications such as live chat and gaming. For more information refer to Can I use Cloudflare with Websockets.

id: Literal["websockets"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time

0-RTT session resumption enabled for this zone.

One of the following:
class ZeroRTT:

0-RTT session resumption enabled for this zone.

id: Literal["0rtt"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class AdvancedDDoS:

Advanced protection from Distributed Denial of Service (DDoS) attacks on your website. This is an uneditable value that is 'on' in the case of Business and Enterprise zones.

id: Literal["advanced_ddos"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesCacheRulesAegis:

Aegis provides dedicated egress IPs (from Cloudflare to your origin) for your layer 7 WAF and CDN services. The egress IPs are reserved exclusively for your account so that you can increase your origin security by only allowing traffic from a small list of IP addresses.

id: Literal["aegis"]

ID of the zone setting.

modified_on: Optional[datetime]

Last time this setting was modified.

formatdate-time
value: Optional[ZonesCacheRulesAegisValue]

Value of the zone setting.

enabled: Optional[bool]

Whether the feature is enabled or not.

pool_id: Optional[str]

Egress pool id which refers to a grouping of dedicated egress IPs through which Cloudflare will connect to origin.

class AlwaysOnline:

When enabled, Cloudflare serves limited copies of web pages available from the Internet Archive's Wayback Machine if your server is offline. Refer to Always Online for more information.

id: Literal["always_online"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasAlwaysUseHTTPS:

Reply to all requests for URLs that use "http" with a 301 redirect to the equivalent "https" URL. If you only want to redirect for a subset of requests, consider creating an "Always use HTTPS" page rule.

id: Literal["always_use_https"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasAutomaticHTTPSRewrites:

Enable the Automatic HTTPS Rewrites feature for this zone.

id: Literal["automatic_https_rewrites"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class Brotli:

When the client requesting an asset supports the Brotli compression algorithm, Cloudflare will serve a Brotli compressed version of the asset.

id: Literal["brotli"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasBrowserCacheTTL:

Browser Cache TTL (in seconds) specifies how long Cloudflare-cached resources will remain on your visitors' computers. Cloudflare will honor any larger times specified by your server. (https://support.cloudflare.com/hc/en-us/articles/200168276).

id: Literal["browser_cache_ttl"]

ID of the zone setting.

value: int

Current value of the zone setting.

maximum31536000
minimum0
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasBrowserCheck:

Browser Integrity Check is similar to Bad Behavior and looks for common HTTP headers abused most commonly by spammers and denies access to your page. It will also challenge visitors that do not have a user agent or a non standard user agent (also commonly used by abuse bots, crawlers or visitors). (https://support.cloudflare.com/hc/en-us/articles/200170086).

id: Literal["browser_check"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasCacheLevel:

Cache Level functions based off the setting level. The basic setting will cache most static resources (i.e., css, images, and JavaScript). The simplified setting will ignore the query string when delivering a cached resource. The aggressive setting will cache all static resources, including ones with a query string. (https://support.cloudflare.com/hc/en-us/articles/200168256).

id: Literal["cache_level"]

ID of the zone setting.

value: Literal["aggressive", "basic", "simplified"]

Current value of the zone setting.

One of the following:
"aggressive"
"basic"
"simplified"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ChallengeTTL:

Specify how long a visitor is allowed access to your site after successfully completing a challenge (such as a CAPTCHA). After the TTL has expired the visitor will have to complete a new challenge. We recommend a 15 - 45 minute setting and will attempt to honor any setting above 45 minutes. (https://support.cloudflare.com/hc/en-us/articles/200170136).

id: Literal["challenge_ttl"]

ID of the zone setting.

value: Literal[300, 900, 1800, 11 more]

Current value of the zone setting.

One of the following:
300
900
1800
2700
3600
7200
10800
14400
28800
57600
86400
604800
2592000
31536000
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesChinaNetworkEnabled:

Determines whether or not the china network is enabled.

id: Literal["china_network_enabled"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesContentConverter:

When enabled and the client sends an Accept header requesting text/markdown, Cloudflare will convert HTML responses to Markdown format using the toMarkdown() service. Refer to the developer documentation for more information.

id: Literal["content_converter"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class Ciphers:

An allowlist of ciphers for TLS termination. These ciphers must be in the BoringSSL format.

id: Literal["ciphers"]

ID of the zone setting.

value: List[str]

Current value of the zone setting.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesCNAMEFlattening:

Whether or not cname flattening is on.

id: Literal["cname_flattening"]

How to flatten the cname destination.

Deprecatedvalue: Literal["flatten_at_root", "flatten_all"]
This zone setting is deprecated; please use the DNS Settings route instead. More information at https://developers.cloudflare.com/fundamentals/api/reference/deprecations/#2025-03-21

Current value of the zone setting.

One of the following:
"flatten_at_root"
"flatten_all"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class DevelopmentMode:

Development Mode temporarily allows you to enter development mode for your websites if you need to make changes to your site. This will bypass Cloudflare's accelerated cache and slow down your site, but is useful if you are making changes to cacheable content (like images, css, or JavaScript) and would like to see those changes right away. Once entered, development mode will last for 3 hours and then automatically toggle off.

id: Literal["development_mode"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
time_remaining: Optional[float]

Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.

class EarlyHints:

When enabled, Cloudflare will attempt to speed up overall page loads by serving 103 responses with Link headers from the final response. Refer to Early Hints for more information.

id: Literal["early_hints"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasEdgeCacheTTL:

Time (in seconds) that a resource will be ensured to remain on Cloudflare's cache servers.

id: Literal["edge_cache_ttl"]

ID of the zone setting.

value: Literal[30, 60, 300, 18 more]

Current value of the zone setting.

One of the following:
30
60
300
1200
1800
3600
7200
10800
14400
18000
28800
43200
57600
72000
86400
172800
259200
345600
432000
518400
604800
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasEmailObfuscation:

Encrypt email adresses on your web page from bots, while keeping them visible to humans. (https://support.cloudflare.com/hc/en-us/articles/200170016).

id: Literal["email_obfuscation"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class H2Prioritization:

HTTP/2 Edge Prioritization optimises the delivery of resources served through HTTP/2 to improve page load performance. It also supports fine control of content delivery when used in conjunction with Workers.

id: Literal["h2_prioritization"]

ID of the zone setting.

value: Literal["on", "off", "custom"]

Current value of the zone setting.

One of the following:
"on"
"off"
"custom"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
One of the following:
One of the following:
class HTTP2:

HTTP2 enabled for this zone.

id: Literal["http2"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class HTTP3:

HTTP3 enabled for this zone.

id: Literal["http3"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ImageResizing:

Image Transformations provides on-demand resizing, conversion and optimization for images served through Cloudflare's network. Refer to the Image Transformations documentation for more information.

id: Literal["image_resizing"]

ID of the zone setting.

value: Literal["on", "off", "open"]

Current value of the zone setting.

One of the following:
"on"
"off"
"open"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasIPGeolocation:

Enable IP Geolocation to have Cloudflare geolocate visitors to your website and pass the country code to you. (https://support.cloudflare.com/hc/en-us/articles/200168236).

id: Literal["ip_geolocation"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class IPV6:

Enable IPv6 on all subdomains that are Cloudflare enabled. (https://support.cloudflare.com/hc/en-us/articles/200168586).

id: Literal["ipv6"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesMaxUpload:

Maximum size of an allowable upload.

id: Literal["max_upload"]

identifier of the zone setting.

value: Literal[100, 125, 150, 15 more]

Current value of the zone setting.

One of the following:
100
125
150
175
200
225
250
275
300
325
350
375
400
425
450
475
500
1000
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class MinTLSVersion:

Only accepts HTTPS requests that use at least the TLS protocol version specified. For example, if TLS 1.1 is selected, TLS 1.0 connections will be rejected, while 1.1, 1.2, and 1.3 (if enabled) will be permitted.

id: Literal["min_tls_version"]

ID of the zone setting.

value: Literal["1.0", "1.1", "1.2", "1.3"]

Current value of the zone setting.

One of the following:
"1.0"
"1.1"
"1.2"
"1.3"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasMirage:

Automatically optimize image loading for website visitors on mobile devices. Refer to our blog post for more information.

id: Literal["mirage"]

ID of the zone setting.

Deprecatedvalue: Literal["on", "off"]
Mirage is being deprecated. More information at https://developers.cloudflare.com/speed/optimization/images/mirage/

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class NEL:

Enable Network Error Logging reporting on your zone. (Beta)

id: Literal["nel"]

Zone setting identifier.

value: Value

Current value of the zone setting.

enabled: Optional[bool]
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasOpportunisticEncryption:

Enables the Opportunistic Encryption feature for a zone.

id: Literal["opportunistic_encryption"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class OpportunisticOnion:

Add an Alt-Svc header to all legitimate requests from Tor, allowing the connection to use our onion services instead of exit nodes.

id: Literal["opportunistic_onion"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class OrangeToOrange:

Orange to Orange (O2O) allows zones on Cloudflare to CNAME to other zones also on Cloudflare.

id: Literal["orange_to_orange"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasOriginErrorPagePassThru:

Cloudflare will proxy customer error pages on any 502,504 errors on origin server instead of showing a default Cloudflare error page. This does not apply to 522 errors and is limited to Enterprise Zones.

id: Literal["origin_error_page_pass_thru"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesCacheRulesOriginH2MaxStreams:

Origin H2 Max Streams configures the max number of concurrent requests that Cloudflare will send within the same connection when communicating with the origin server, if the origin supports it. Note that if your origin does not support H2 multiplexing, 5xx errors may be observed, particularly 520s. Also note that the default value is 100 for all plan types except Enterprise where it is 1. 1 means that H2 multiplexing is disabled.

id: Literal["origin_h2_max_streams"]

Value of the zone setting.

modified_on: Optional[datetime]

Last time this setting was modified.

formatdate-time
value: Optional[int]

Value of the Origin H2 Max Streams Setting.

maximum1000
minimum1
class ZonesCacheRulesOriginMaxHTTPVersion:

Origin Max HTTP Setting Version sets the highest HTTP version Cloudflare will attempt to use with your origin. This setting allows Cloudflare to make HTTP/2 requests to your origin. (Refer to Enable HTTP/2 to Origin, for more information.). The default value is "2" for all plan types except Enterprise where it is "1".

id: Literal["origin_max_http_version"]

Value of the zone setting.

modified_on: Optional[datetime]

Last time this setting was modified.

formatdate-time
value: Optional[Literal["2", "1"]]

Value of the Origin Max HTTP Version Setting.

One of the following:
"2"
"1"
class ZonesSchemasPolish:

Removes metadata and compresses your images for faster page load times. Basic (Lossless): Reduce the size of PNG, JPEG, and GIF files - no impact on visual quality. Basic + JPEG (Lossy): Further reduce the size of JPEG files for faster image loading. Larger JPEGs are converted to progressive images, loading a lower-resolution image first and ending in a higher-resolution version. Not recommended for hi-res photography sites.

id: Literal["polish"]

ID of the zone setting.

value: Literal["off", "lossless", "lossy"]

Current value of the zone setting.

One of the following:
"off"
"lossless"
"lossy"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class PrefetchPreload:

Cloudflare will prefetch any URLs that are included in the response headers. This is limited to Enterprise Zones.

id: Literal["prefetch_preload"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesPrivacyPass:

Privacy Pass v1 was a browser extension developed by the Privacy Pass Team to improve the browsing experience for your visitors by allowing users to reduce the number of CAPTCHAs shown. (https://support.cloudflare.com/hc/en-us/articles/115001992652-Privacy-Pass).

id: Literal["privacy_pass"]

ID of the zone setting.

Deprecatedvalue: Literal["on", "off"]
Privacy Pass v1 was deprecated in 2023. (Announcement - https://blog.cloudflare.com/privacy-pass-standard/) and (API deprecation details - https://developers.cloudflare.com/fundamentals/api/reference/deprecations/#2024-03-31)

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ProxyReadTimeout:

Maximum time between two read operations from origin.

id: Literal["proxy_read_timeout"]

ID of the zone setting.

value: float

Current value of the zone setting.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class PseudoIPV4:

The value set for the Pseudo IPv4 setting.

id: Literal["pseudo_ipv4"]

Value of the Pseudo IPv4 setting.

value: Literal["off", "add_header", "overwrite_header"]

Current value of the zone setting.

One of the following:
"off"
"add_header"
"overwrite_header"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesRedirectsForAITraining:

When enabled, Cloudflare will redirect verified AI training crawlers to canonical URLs found in the HTML response, ensuring AI models train on authoritative content.

id: Literal["redirects_for_ai_training"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesReplaceInsecureJS:

Automatically replace insecure JavaScript libraries with safer and faster alternatives provided under cdnjs and powered by Cloudflare. Currently supports the following libraries: Polyfill under polyfill.io.

id: Literal["replace_insecure_js"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasResponseBuffering:

Enables or disables buffering of responses from the proxied server. Cloudflare may buffer the whole payload to deliver it at once to the client versus allowing it to be delivered in chunks. By default, the proxied server streams directly and is not buffered by Cloudflare. This is limited to Enterprise Zones.

id: Literal["response_buffering"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasRocketLoader:

Rocket Loader is a general-purpose asynchronous JavaScript optimisation that prioritises rendering your content while loading your site's Javascript asynchronously. Turning on Rocket Loader will immediately improve a web page's rendering time sometimes measured as Time to First Paint (TTFP), and also the window.onload time (assuming there is JavaScript on the page). This can have a positive impact on your Google search ranking. When turned on, Rocket Loader will automatically defer the loading of all Javascript referenced in your HTML, with no configuration required. Refer to Understanding Rocket Loader for more information.

id: Literal["rocket_loader"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasAutomaticPlatformOptimization:

Automatic Platform Optimization for WordPress serves your WordPress site from Cloudflare's edge network and caches third-party fonts.

id: Literal["automatic_platform_optimization"]

ID of the zone setting.

Current value of the zone setting.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class SecurityHeaders:

Cloudflare security header for a zone.

id: Literal["security_header"]

ID of the zone's security header.

value: Value

Current value of the zone setting.

strict_transport_security: Optional[ValueStrictTransportSecurity]

Strict Transport Security.

enabled: Optional[bool]

Whether or not strict transport security is enabled.

include_subdomains: Optional[bool]

Include all subdomains for strict transport security.

max_age: Optional[float]

Max age in seconds of the strict transport security.

nosniff: Optional[bool]

Whether or not to include 'X-Content-Type-Options: nosniff' header.

preload: Optional[bool]

Enable automatic preload of the HSTS configuration.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasSecurityLevel:

Choose the appropriate security profile for your website, which will automatically adjust each of the security settings. If you choose to customize an individual security setting, the profile will become Custom. (https://support.cloudflare.com/hc/en-us/articles/200170056).

id: Literal["security_level"]

ID of the zone setting.

value: Literal["off", "essentially_off", "low", 3 more]

Current value of the zone setting.

One of the following:
"off"
"essentially_off"
"low"
"medium"
"high"
"under_attack"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ServerSideExcludes:

If there is sensitive content on your website that you want visible to real visitors, but that you want to hide from suspicious visitors, all you have to do is wrap the content with Cloudflare SSE tags. Wrap any content that you want to be excluded from suspicious visitors in the following SSE tags: . For example: Bad visitors won't see my phone number, 555-555-5555 . Note: SSE only will work with HTML. If you have HTML minification enabled, you won't see the SSE tags in your HTML source when it's served through Cloudflare. SSE will still function in this case, as Cloudflare's HTML minification and SSE functionality occur on-the-fly as the resource moves through our network to the visitor's computer. (https://support.cloudflare.com/hc/en-us/articles/200170036).

id: Literal["server_side_exclude"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSha1Support:

Allow SHA1 support.

id: Literal["sha1_support"]

Zone setting identifier.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasSortQueryStringForCache:

Cloudflare will treat files with the same query strings as the same file in cache, regardless of the order of the query strings. This is limited to Enterprise Zones.

id: Literal["sort_query_string_for_cache"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasSSL:

SSL encrypts your visitor's connection and safeguards credit card numbers and other personal data to and from your website. SSL can take up to 5 minutes to fully activate. Requires Cloudflare active on your root domain or www domain. Off: no SSL between the visitor and Cloudflare, and no SSL between Cloudflare and your web server (all HTTP traffic). Flexible: SSL between the visitor and Cloudflare -- visitor sees HTTPS on your site, but no SSL between Cloudflare and your web server. You don't need to have an SSL cert on your web server, but your vistors will still see the site as being HTTPS enabled. Full: SSL between the visitor and Cloudflare -- visitor sees HTTPS on your site, and SSL between Cloudflare and your web server. You'll need to have your own SSL cert or self-signed cert at the very least. Full (Strict): SSL between the visitor and Cloudflare -- visitor sees HTTPS on your site, and SSL between Cloudflare and your web server. You'll need to have a valid SSL certificate installed on your web server. This certificate must be signed by a certificate authority, have an expiration date in the future, and respond for the request domain name (hostname). (https://support.cloudflare.com/hc/en-us/articles/200170416).

id: Literal["ssl"]

ID of the zone setting.

value: Literal["off", "flexible", "full", "strict"]

Current value of the zone setting.

One of the following:
"off"
"flexible"
"full"
"strict"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class SSLRecommender:

Enrollment in the SSL/TLS Recommender service which tries to detect and recommend (by sending periodic emails) the most secure SSL/TLS setting your origin servers support.

id: Optional[Literal["ssl_recommender"]]

Enrollment value for SSL/TLS Recommender.

enabled: Optional[bool]

ssl-recommender enrollment setting.

class ZonesTLS1_2Only:

Only allows TLS1.2.

id: Literal["tls_1_2_only"]

Zone setting identifier.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class TLS1_3:

Enables Crypto TLS 1.3 feature for a zone.

id: Literal["tls_1_3"]

ID of the zone setting.

value: Literal["on", "off", "zrt"]

Current value of the zone setting.

One of the following:
"on"
"off"
"zrt"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class TLSClientAuth:

TLS Client Auth requires Cloudflare to connect to your origin server using a client certificate (Enterprise Only).

id: Literal["tls_client_auth"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesTransformations:

Media Transformations provides on-demand resizing, conversion and optimization for images and video served through Cloudflare's network. Refer to the Image Transformations and Video Transformations documentation for more information.

id: Literal["transformations"]

ID of the zone setting. Shared between Image Transformations and Video Transformations.

value: Literal["on", "off", "open"]

Current value of the zone setting.

One of the following:
"on"
"off"
"open"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesTransformationsAllowedOrigins:

Media Transformations Allowed Origins restricts transformations for images and video served through Cloudflare's network. Refer to the Image Transformations and Video Transformations documentation for more information.

id: Literal["transformations_allowed_origins"]

ID of the zone setting. Shared between Image Transformations and Video Transformations.

value: str

Current value of the zone setting.

editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasTrueClientIPHeader:

Allows customer to continue to use True Client IP (Akamai feature) in the headers we send to the origin. This is limited to Enterprise Zones.

id: Literal["true_client_ip_header"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class ZonesSchemasWAF:

The WAF examines HTTP requests to your website. It inspects both GET and POST requests and applies rules to help filter out illegitimate traffic from legitimate website visitors. The Cloudflare WAF inspects website addresses or URLs to detect anything out of the ordinary. If the Cloudflare WAF determines suspicious user behavior, then the WAF will 'challenge' the web visitor with a page that asks them to submit a CAPTCHA successfully to continue their action. If the challenge is failed, the action will be stopped. What this means is that Cloudflare's WAF will block any traffic identified as illegitimate before it reaches your origin web server. (https://support.cloudflare.com/hc/en-us/articles/200172016).

id: Literal["waf"]

ID of the zone setting.

value: Literal["on", "off"]

Current value of the zone setting.

One of the following:
"on"
"off"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class WebP:

When the client requesting the image supports the WebP image codec, and WebP offers a performance advantage over the original image format, Cloudflare will serve a WebP version of the original image.

id: Literal["webp"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time
class Websocket:

WebSockets are open connections sustained between the client and the origin server. Inside a WebSockets connection, the client and the origin can pass data back and forth without having to reestablish sessions. This makes exchanging data within a WebSockets connection fast. WebSockets are often used for real-time applications such as live chat and gaming. For more information refer to Can I use Cloudflare with Websockets.

id: Literal["websockets"]

ID of the zone setting.

value: Literal["off", "on"]

Current value of the zone setting.

One of the following:
"off"
"on"
editable: Optional[Literal[true, false]]

Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).

One of the following:
true
false
modified_on: Optional[datetime]

last time this setting was modified.

formatdate-time

ZonesCustom Nameservers

Get Account Custom Nameserver Related Zone Metadata
Deprecated
zones.custom_nameservers.get(CustomNameserverGetParams**kwargs) -> CustomNameserverGetResponse
GET/zones/{zone_id}/custom_ns
Set Account Custom Nameserver Related Zone Metadata
Deprecated
zones.custom_nameservers.update(CustomNameserverUpdateParams**kwargs) -> SyncSinglePage[CustomNameserverUpdateResponse]
PUT/zones/{zone_id}/custom_ns
ModelsExpand Collapse
class CustomNameserverGetResponse:
errors: List[Error]
code: int
minimum1000
message: str
documentation_url: Optional[str]
source: Optional[ErrorSource]
pointer: Optional[str]
messages: List[Message]
code: int
minimum1000
message: str
documentation_url: Optional[str]
source: Optional[MessageSource]
pointer: Optional[str]
success: Literal[true]

Whether the API call was successful.

enabled: Optional[bool]

Whether zone uses account-level custom nameservers.

ns_set: Optional[float]

The number of the name server set to assign to the zone.

maximum5
minimum1
result_info: Optional[ResultInfo]
count: Optional[float]

Total number of results for the requested service.

page: Optional[float]

Current page within paginated list of results.

per_page: Optional[float]

Number of results per page of results.

total_count: Optional[float]

Total results available without any search parameters.

str

Unused

ZonesHolds

Get Zone Hold
zones.holds.get(HoldGetParams**kwargs) -> ZoneHold
GET/zones/{zone_id}/hold
Create Zone Hold
zones.holds.create(HoldCreateParams**kwargs) -> ZoneHold
POST/zones/{zone_id}/hold
Update Zone Hold
zones.holds.edit(HoldEditParams**kwargs) -> ZoneHold
PATCH/zones/{zone_id}/hold
Remove Zone Hold
zones.holds.delete(HoldDeleteParams**kwargs) -> ZoneHold
DELETE/zones/{zone_id}/hold
ModelsExpand Collapse
class ZoneHold:
hold: Optional[bool]
hold_after: Optional[str]
include_subdomains: Optional[str]

ZonesSubscriptions

Zone Subscription Details
zones.subscriptions.get(SubscriptionGetParams**kwargs) -> SubscriptionGetResponse
GET/zones/{zone_id}/subscription
Create Zone Subscription
zones.subscriptions.create(SubscriptionCreateParams**kwargs) -> SubscriptionCreateResponse
POST/zones/{zone_id}/subscription
Update Zone Subscription
zones.subscriptions.update(SubscriptionUpdateParams**kwargs) -> SubscriptionUpdateResponse
PUT/zones/{zone_id}/subscription
ModelsExpand Collapse
class SubscriptionGetResponse:
id: Optional[str]

Subscription identifier tag.

maxLength32
currency: Optional[str]

The monetary unit in which pricing information is displayed.

current_period_end: Optional[datetime]

The end of the current period and also when the next billing is due.

formatdate-time
current_period_start: Optional[datetime]

When the current billing period started. May match initial_period_start if this is the first period.

formatdate-time
frequency: Optional[Literal["weekly", "monthly", "quarterly", 2 more]]

How often the subscription is renewed automatically.

One of the following:
"weekly"
"monthly"
"quarterly"
"yearly"
"not-applicable"
price: Optional[float]

The price of the subscription that will be billed, in US dollars.

rate_plan: Optional[RatePlan]

The rate plan applied to the subscription.

state: Optional[Literal["Trial", "Provisioned", "Paid", 4 more]]

The state that the subscription is in.

One of the following:
"Trial"
"Provisioned"
"Paid"
"AwaitingPayment"
"Cancelled"
"Failed"
"Expired"
class SubscriptionCreateResponse:
id: Optional[str]

Subscription identifier tag.

maxLength32
currency: Optional[str]

The monetary unit in which pricing information is displayed.

current_period_end: Optional[datetime]

The end of the current period and also when the next billing is due.

formatdate-time
current_period_start: Optional[datetime]

When the current billing period started. May match initial_period_start if this is the first period.

formatdate-time
frequency: Optional[Literal["weekly", "monthly", "quarterly", 2 more]]

How often the subscription is renewed automatically.

One of the following:
"weekly"
"monthly"
"quarterly"
"yearly"
"not-applicable"
price: Optional[float]

The price of the subscription that will be billed, in US dollars.

rate_plan: Optional[RatePlan]

The rate plan applied to the subscription.

state: Optional[Literal["Trial", "Provisioned", "Paid", 4 more]]

The state that the subscription is in.

One of the following:
"Trial"
"Provisioned"
"Paid"
"AwaitingPayment"
"Cancelled"
"Failed"
"Expired"
class SubscriptionUpdateResponse:
id: Optional[str]

Subscription identifier tag.

maxLength32
currency: Optional[str]

The monetary unit in which pricing information is displayed.

current_period_end: Optional[datetime]

The end of the current period and also when the next billing is due.

formatdate-time
current_period_start: Optional[datetime]

When the current billing period started. May match initial_period_start if this is the first period.

formatdate-time
frequency: Optional[Literal["weekly", "monthly", "quarterly", 2 more]]

How often the subscription is renewed automatically.

One of the following:
"weekly"
"monthly"
"quarterly"
"yearly"
"not-applicable"
price: Optional[float]

The price of the subscription that will be billed, in US dollars.

rate_plan: Optional[RatePlan]

The rate plan applied to the subscription.

state: Optional[Literal["Trial", "Provisioned", "Paid", 4 more]]

The state that the subscription is in.

One of the following:
"Trial"
"Provisioned"
"Paid"
"AwaitingPayment"
"Cancelled"
"Failed"
"Expired"

ZonesPlans

List Available Plans
zones.plans.list(PlanListParams**kwargs) -> SyncSinglePage[AvailableRatePlan]
GET/zones/{zone_id}/available_plans
Available Plan Details
zones.plans.get(strplan_identifier, PlanGetParams**kwargs) -> AvailableRatePlan
GET/zones/{zone_id}/available_plans/{plan_identifier}
ModelsExpand Collapse
class AvailableRatePlan:
id: Optional[str]

Identifier

maxLength32
can_subscribe: Optional[bool]

Indicates whether you can subscribe to this plan.

currency: Optional[str]

The monetary unit in which pricing information is displayed.

externally_managed: Optional[bool]

Indicates whether this plan is managed externally.

frequency: Optional[Literal["weekly", "monthly", "quarterly", "yearly"]]

The frequency at which you will be billed for this plan.

One of the following:
"weekly"
"monthly"
"quarterly"
"yearly"
is_subscribed: Optional[bool]

Indicates whether you are currently subscribed to this plan.

legacy_discount: Optional[bool]

Indicates whether this plan has a legacy discount applied.

legacy_id: Optional[str]

The legacy identifier for this rate plan, if any.

name: Optional[str]

The plan name.

maxLength80
price: Optional[float]

The amount you will be billed for this plan.

ZonesRate Plans

List Available Rate Plans
zones.rate_plans.get(RatePlanGetParams**kwargs) -> SyncSinglePage[RatePlanGetResponse]
GET/zones/{zone_id}/available_rate_plans
ModelsExpand Collapse
class RatePlanGetResponse:
id: Optional[str]

Plan identifier tag.

components: Optional[List[Component]]

Array of available components values for the plan.

default: Optional[float]

The default amount allocated.

name: Optional[Literal["zones", "page_rules", "dedicated_certificates", "dedicated_certificates_custom"]]

The unique component.

One of the following:
"zones"
"page_rules"
"dedicated_certificates"
"dedicated_certificates_custom"
unit_price: Optional[float]

The unit price of the addon.

currency: Optional[str]

The monetary unit in which pricing information is displayed.

duration: Optional[float]

The duration of the plan subscription.

frequency: Optional[Literal["weekly", "monthly", "quarterly", "yearly"]]

The frequency at which you will be billed for this plan.

One of the following:
"weekly"
"monthly"
"quarterly"
"yearly"
name: Optional[str]

The plan name.

maxLength80