--- title: Settings --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [DNS](https://developers.cloudflare.com/api/resources/dns) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Settings #### SettingsZone ##### [Show DNS Settings](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/zone/methods/get) GET/zones/{zone\_id}/dns\_settings ##### [Update DNS Settings](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/zone/methods/edit) PATCH/zones/{zone\_id}/dns\_settings ##### ModelsExpand Collapse

ZoneGetResponse object {flatten\_all\_cnames, foundation\_dns, internal\_dns, 6 more }

flatten\_all\_cnames: boolean Whether to flatten all CNAME records in the zone. Note that, due to DNS limitations, a CNAME record at the zone apex will always be flattened. Link to this property Deprecatedfoundation\_dns: boolean foundation\_dns is deprecated. Use nameservers.type: cloudflare.advanced to turn on Advanced Nameservers and cloudflare.standard to turn it off. This field will be removed in a future API version. Deprecated. Use nameservers.type to configure Advanced Nameservers. Link to this property

internal\_dns: object {reference\_zone\_id } Settings for this internal zone.

reference\_zone\_id: optional string The ID of the zone to fallback to. Link to this property

Link to this property multi\_provider: boolean Whether to enable multi-provider DNS, which causes Cloudflare to activate the zone even when non-Cloudflare NS records exist, and to respect NS records at the zone apex during outbound zone transfers. Link to this property

nameservers: object {type } or object {type, ns\_set } or object {nameserver\_set\_id, type } Controls the nameservers through which the zone is available.

One of the following:

DNSSettingsZoneNameserversCloudflare object {type }

type: "cloudflare.standard"or "cloudflare.advanced" Nameserver type.

One of the following: "cloudflare.standard" Link to this property "cloudflare.advanced" Link to this property

Link to this property

DNSSettingsZoneNameserversCustomExisting object {type, ns\_set }

type: "custom.account"or "custom.tenant"or "custom.zone" Nameserver type.

One of the following: "custom.account" Link to this property "custom.tenant" Link to this property "custom.zone" Link to this property

Link to this property ns\_set: optional number Configured nameserver set number to use for this zone. maximum5 minimum1 Link to this property

Link to this property

DNSSettingsZoneNameserversCustomSet object {nameserver\_set\_id, type }

nameserver\_set\_id: string Identifier of the account-owned Custom Nameserver Set to use for this zone. maxLength32 minLength32 Link to this property type: "custom" Nameserver type. Link to this property

Link to this property

Link to this property ns\_ttl: number The time to live (TTL) of the zone’s nameserver (NS) records. maximum86400 minimum30 Link to this property secondary\_overrides: boolean Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex. Link to this property

soa: object {expire, min\_ttl, mname, 4 more } Components of the zone’s SOA record.

expire: optional number Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone. maximum2419200 minimum86400 Link to this property min\_ttl: optional number The time to live (TTL) for negative caching of records within the zone. maximum86400 minimum60 Link to this property mname: optional string The primary nameserver, which may be used for outbound zone transfers. If null, a Cloudflare-assigned value will be used. Link to this property refresh: optional number Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated. maximum86400 minimum600 Link to this property retry: optional number Time in seconds after which secondary servers should retry queries after the primary server was unresponsive. maximum86400 minimum600 Link to this property rname: optional string The email address of the zone administrator, with the first label representing the local part of the email address. Link to this property ttl: optional number The time to live (TTL) of the SOA record itself. maximum86400 minimum300 Link to this property

Link to this property

zone\_mode: "standard"or "cdn\_only"or "dns\_only" Whether the zone mode is a regular or CDN/DNS only zone.

One of the following: "standard" Link to this property "cdn\_only" Link to this property "dns\_only" Link to this property

Link to this property

[Link to this property](<#(resource)%20dns.settings.zone%20%3E%20(model)%20zone_get_response%20%3E%20(schema)>)

ZoneEditResponse object {flatten\_all\_cnames, foundation\_dns, internal\_dns, 6 more }

internal\_dns: object {reference\_zone\_id } Settings for this internal zone.

reference\_zone\_id: optional string The ID of the zone to fallback to. Link to this property

nameservers: object {type } or object {type, ns\_set } or object {nameserver\_set\_id, type } Controls the nameservers through which the zone is available.

One of the following:

DNSSettingsZoneNameserversCloudflare object {type }

type: "cloudflare.standard"or "cloudflare.advanced" Nameserver type.

One of the following: "cloudflare.standard" Link to this property "cloudflare.advanced" Link to this property

Link to this property

DNSSettingsZoneNameserversCustomExisting object {type, ns\_set }

type: "custom.account"or "custom.tenant"or "custom.zone" Nameserver type.

One of the following: "custom.account" Link to this property "custom.tenant" Link to this property "custom.zone" Link to this property

Link to this property ns\_set: optional number Configured nameserver set number to use for this zone. maximum5 minimum1 Link to this property

Link to this property

DNSSettingsZoneNameserversCustomSet object {nameserver\_set\_id, type }

Link to this property

soa: object {expire, min\_ttl, mname, 4 more } Components of the zone’s SOA record.

Link to this property

zone\_mode: "standard"or "cdn\_only"or "dns\_only" Whether the zone mode is a regular or CDN/DNS only zone.

One of the following: "standard" Link to this property "cdn\_only" Link to this property "dns\_only" Link to this property

Link to this property

[Link to this property](<#(resource)%20dns.settings.zone%20%3E%20(model)%20zone_edit_response%20%3E%20(schema)>) #### SettingsAccount ##### [Show DNS Settings](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/methods/get) GET/accounts/{account\_id}/dns\_settings ##### [Update DNS Settings](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/methods/edit) PATCH/accounts/{account\_id}/dns\_settings ##### ModelsExpand Collapse

AccountGetResponse object {zone\_defaults, enforce\_dns\_only }

zone\_defaults: object {flatten\_all\_cnames, foundation\_dns, internal\_dns, 6 more } Default settings for new zones created in this account.

internal\_dns: object {reference\_zone\_id } Settings for this internal zone.

reference\_zone\_id: optional string The ID of the zone to fallback to. Link to this property

nameservers: object {type } Settings determining the nameservers through which the zone should be available.

type: "cloudflare.standard"or "cloudflare.advanced"or "cloudflare.standard.random"or 2 more Nameserver type

One of the following: "cloudflare.standard" Link to this property "cloudflare.advanced" Link to this property "cloudflare.standard.random" Link to this property "custom.account" Link to this property "custom.tenant" Link to this property

Link to this property

soa: object {expire, min\_ttl, mname, 4 more } Components of the zone’s SOA record.

Link to this property

zone\_mode: "standard"or "cdn\_only"or "dns\_only" Whether the zone mode is a regular or CDN/DNS only zone.

One of the following: "standard" Link to this property "cdn\_only" Link to this property "dns\_only" Link to this property

Link to this property

Link to this property enforce\_dns\_only: optional boolean When enabled, forces all proxied DNS records in the account to behave as DNS-only at the edge, regardless of each record’s individual proxy setting. Note that this account-level override does not modify the records themselves; it only affects how they are served at the edge. See more on Enforce DNS-only. Link to this property

[Link to this property](<#(resource)%20dns.settings.account%20%3E%20(model)%20account_get_response%20%3E%20(schema)>)

AccountEditResponse object {zone\_defaults, enforce\_dns\_only }

zone\_defaults: object {flatten\_all\_cnames, foundation\_dns, internal\_dns, 6 more } Default settings for new zones created in this account.

internal\_dns: object {reference\_zone\_id } Settings for this internal zone.

reference\_zone\_id: optional string The ID of the zone to fallback to. Link to this property

nameservers: object {type } Settings determining the nameservers through which the zone should be available.

type: "cloudflare.standard"or "cloudflare.advanced"or "cloudflare.standard.random"or 2 more Nameserver type

Link to this property

soa: object {expire, min\_ttl, mname, 4 more } Components of the zone’s SOA record.

Link to this property

zone\_mode: "standard"or "cdn\_only"or "dns\_only" Whether the zone mode is a regular or CDN/DNS only zone.

One of the following: "standard" Link to this property "cdn\_only" Link to this property "dns\_only" Link to this property

Link to this property

[Link to this property](<#(resource)%20dns.settings.account%20%3E%20(model)%20account_edit_response%20%3E%20(schema)>) #### SettingsAccountNameserver Sets ##### [List Custom Nameserver Sets](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/subresources/nameserver_sets/methods/list) GET/accounts/{account\_id}/dns\_settings/nameserver\_sets ##### [Get Custom Nameserver Set](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/subresources/nameserver_sets/methods/get) GET/accounts/{account\_id}/dns\_settings/nameserver\_sets/{nameserver\_set\_id} ##### [Create Custom Nameserver Set](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/subresources/nameserver_sets/methods/create) POST/accounts/{account\_id}/dns\_settings/nameserver\_sets ##### [Delete Custom Nameserver Set](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/subresources/nameserver_sets/methods/delete) DELETE/accounts/{account\_id}/dns\_settings/nameserver\_sets/{nameserver\_set\_id} ##### ModelsExpand Collapse

NameserverSetListResponse = object {id, advanced, created\_on, 2 more } or object {id, advanced, created\_on, 2 more }

One of the following:

DNSSettingsNameserverSetStandardResponse object {id, advanced, created\_on, 2 more }

id: string Identifier for a nameserver set. maxLength32 minLength32 Link to this property advanced: false Whether the nameserver set uses Advanced anycast groups. Link to this property created\_on: string When the nameserver set was created. formatdate-time Link to this property ip\_set: number Selects the account-specific IP set that supplies the nameserver addresses. The account’s entitlement determines the maximum value. Nameserver sets with the same ip_set and advanced value may reuse addresses; otherwise, they use disjoint address groups. formatint64 minimum1 Link to this property

nameservers: array of object {ipv4, ipv6, name }

ipv4: array of string IPv4 addresses assigned to the nameserver. Link to this property ipv6: array of string IPv6 addresses assigned to the nameserver. Link to this property name: string A unique lowercase Punycode nameserver name within the set. Link to this property

Link to this property

DNSSettingsNameserverSetAdvancedResponse object {id, advanced, created\_on, 2 more }

id: string Identifier for a nameserver set. maxLength32 minLength32 Link to this property advanced: true Whether the nameserver set uses Advanced anycast groups. Link to this property created\_on: string When the nameserver set was created. formatdate-time Link to this property ip\_set: number Selects the account-specific IP set that supplies the nameserver addresses. The account’s entitlement determines the maximum value. Nameserver sets with the same ip_set and advanced value may reuse addresses; otherwise, they use disjoint address groups. formatint64 minimum1 Link to this property

nameservers: array of object {ipv4, ipv4\_groups, ipv6, 2 more }

ipv4: array of string IPv4 addresses assigned to the nameserver. Link to this property

ipv4\_groups: array of "a"or "b"or "c" Advanced anycast group for each address in the corresponding address array. Entries have the same order as, and correspond one-to-one with, the addresses.

One of the following: "a" Link to this property "b" Link to this property "c" Link to this property

Link to this property ipv6: array of string IPv6 addresses assigned to the nameserver. Link to this property

ipv6\_groups: array of "a"or "b"or "c" Advanced anycast group for each address in the corresponding address array. Entries have the same order as, and correspond one-to-one with, the addresses.

One of the following: "a" Link to this property "b" Link to this property "c" Link to this property

Link to this property name: string A unique lowercase Punycode nameserver name within the set. Link to this property

Link to this property

[Link to this property](<#(resource)%20dns.settings.account.nameserver_sets%20%3E%20(model)%20nameserver_set_list_response%20%3E%20(schema)>)

NameserverSetGetResponse = object {id, advanced, created\_on, 2 more } or object {id, advanced, created\_on, 2 more }

One of the following:

DNSSettingsNameserverSetStandardResponse object {id, advanced, created\_on, 2 more }

nameservers: array of object {ipv4, ipv6, name }

Link to this property

DNSSettingsNameserverSetAdvancedResponse object {id, advanced, created\_on, 2 more }

nameservers: array of object {ipv4, ipv4\_groups, ipv6, 2 more }

ipv4: array of string IPv4 addresses assigned to the nameserver. Link to this property

ipv4\_groups: array of "a"or "b"or "c" Advanced anycast group for each address in the corresponding address array. Entries have the same order as, and correspond one-to-one with, the addresses.

One of the following: "a" Link to this property "b" Link to this property "c" Link to this property

Link to this property ipv6: array of string IPv6 addresses assigned to the nameserver. Link to this property

ipv6\_groups: array of "a"or "b"or "c" Advanced anycast group for each address in the corresponding address array. Entries have the same order as, and correspond one-to-one with, the addresses.

One of the following: "a" Link to this property "b" Link to this property "c" Link to this property

Link to this property name: string A unique lowercase Punycode nameserver name within the set. Link to this property

Link to this property

[Link to this property](<#(resource)%20dns.settings.account.nameserver_sets%20%3E%20(model)%20nameserver_set_get_response%20%3E%20(schema)>)

NameserverSetCreateResponse = object {id, advanced, created\_on, 2 more } or object {id, advanced, created\_on, 2 more }

One of the following:

DNSSettingsNameserverSetStandardResponse object {id, advanced, created\_on, 2 more }

nameservers: array of object {ipv4, ipv6, name }

Link to this property

DNSSettingsNameserverSetAdvancedResponse object {id, advanced, created\_on, 2 more }

nameservers: array of object {ipv4, ipv4\_groups, ipv6, 2 more }

ipv4: array of string IPv4 addresses assigned to the nameserver. Link to this property

ipv4\_groups: array of "a"or "b"or "c" Advanced anycast group for each address in the corresponding address array. Entries have the same order as, and correspond one-to-one with, the addresses.

One of the following: "a" Link to this property "b" Link to this property "c" Link to this property

Link to this property ipv6: array of string IPv6 addresses assigned to the nameserver. Link to this property

ipv6\_groups: array of "a"or "b"or "c" Advanced anycast group for each address in the corresponding address array. Entries have the same order as, and correspond one-to-one with, the addresses.

One of the following: "a" Link to this property "b" Link to this property "c" Link to this property

Link to this property name: string A unique lowercase Punycode nameserver name within the set. Link to this property

Link to this property

[Link to this property](<#(resource)%20dns.settings.account.nameserver_sets%20%3E%20(model)%20nameserver_set_create_response%20%3E%20(schema)>)

NameserverSetDeleteResponse object {id }

id: string Identifier for a nameserver set. maxLength32 minLength32 Link to this property

[Link to this property](<#(resource)%20dns.settings.account.nameserver_sets%20%3E%20(model)%20nameserver_set_delete_response%20%3E%20(schema)>) #### SettingsAccountViews ##### [List Internal DNS Views](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/subresources/views/methods/list) GET/accounts/{account\_id}/dns\_settings/views ##### [DNS Internal View Details](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/subresources/views/methods/get) GET/accounts/{account\_id}/dns\_settings/views/{view\_id} ##### [Create Internal DNS View](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/subresources/views/methods/create) POST/accounts/{account\_id}/dns\_settings/views ##### [Update Internal DNS View](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/subresources/views/methods/edit) PATCH/accounts/{account\_id}/dns\_settings/views/{view\_id} ##### [Delete Internal DNS View](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/subresources/views/methods/delete) DELETE/accounts/{account\_id}/dns\_settings/views/{view\_id} ##### ModelsExpand Collapse

ViewListResponse object {id, created\_time, modified\_time, 2 more }

id: string Identifier. maxLength32 Link to this property created\_time: string When the view was created. formatdate-time Link to this property modified\_time: string When the view was last modified. formatdate-time Link to this property name: string The name of the view. maxLength255 minLength1 Link to this property zones: array of string The list of zones linked to this view. Link to this property

[Link to this property](<#(resource)%20dns.settings.account.views%20%3E%20(model)%20view_list_response%20%3E%20(schema)>)

ViewGetResponse object {id, created\_time, modified\_time, 2 more }

[Link to this property](<#(resource)%20dns.settings.account.views%20%3E%20(model)%20view_get_response%20%3E%20(schema)>)

ViewCreateResponse object {id, created\_time, modified\_time, 2 more }

[Link to this property](<#(resource)%20dns.settings.account.views%20%3E%20(model)%20view_create_response%20%3E%20(schema)>)

ViewEditResponse object {id, created\_time, modified\_time, 2 more }

[Link to this property](<#(resource)%20dns.settings.account.views%20%3E%20(model)%20view_edit_response%20%3E%20(schema)>)

ViewDeleteResponse object {id }

id: optional string Identifier. maxLength32 Link to this property

[Link to this property](<#(resource)%20dns.settings.account.views%20%3E%20(model)%20view_delete_response%20%3E%20(schema)>)