DNS
DNSDNSSEC
DNSSEC Details
Edit DNSSEC Status
Delete DNSSEC records
ModelsExpand Collapse
DNSSEC { algorithm, digest, digest_algorithm, 11 more }
If true, multi-signer DNSSEC is enabled on the zone, allowing multiple providers to serve a DNSSEC-signed zone at the same time. This is required for DNSKEY records (except those automatically generated by Cloudflare) to be added to the zone.
See Multi-signer DNSSEC for details.
If true, allows Cloudflare to transfer in a DNSSEC-signed zone including signatures from an external provider, without requiring Cloudflare to sign any records on the fly.
Note that this feature has some limitations. See Cloudflare as Secondary for details.
If true, enables the use of NSEC3 together with DNSSEC on the zone. Combined with setting dnssec_presigned to true, this enables the use of NSEC3 records when transferring in from an external provider. If dnssec_presigned is instead set to false (default), NSEC3 records will be generated and signed at request time.
See DNSSEC with NSEC3 for details.
DNSRecords
List DNS Records
DNS Record Details
Create DNS Record
Overwrite DNS Record
Update DNS Record
Delete DNS Record
Export DNS Records
Import DNS Records
Scan DNS Records
Trigger DNS Record Scan
Review Scanned DNS Records
List Scanned DNS Records
Batch DNS Records
ModelsExpand Collapse
ARecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
AAAARecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
BatchPatch = ARecord { id } | AAAARecord { id } | CNAMERecord { id } | 18 more
OpenpgpkeyRecord { id, name, ttl, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
BatchPut = ARecord { id } | AAAARecord { id } | CNAMERecord { id } | 18 more
OpenpgpkeyRecord { id, name, ttl, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
CAARecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
CERTRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
CNAMERecord { name, ttl, type, 5 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { flatten_cname, ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
If enabled, causes the CNAME record to be resolved externally and the resulting address records (e.g., A and AAAA) to be returned instead of the CNAME record itself. This setting is unavailable for proxied records, since they are always flattened.
DNSKEYRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
DSRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
HTTPSRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
LOCRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
MXRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
NAPTRRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
NSRecord { name, ttl, type, 5 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
PTRRecord { name, ttl, type, 5 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
Record = ARecord { name, ttl, type, 6 more } | AAAARecord { name, ttl, type, 6 more } | CNAMERecord { name, ttl, type, 5 more } | 18 more
ARecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
AAAARecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
CNAMERecord { name, ttl, type, 5 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { flatten_cname, ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
If enabled, causes the CNAME record to be resolved externally and the resulting address records (e.g., A and AAAA) to be returned instead of the CNAME record itself. This setting is unavailable for proxied records, since they are always flattened.
MXRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
NSRecord { name, ttl, type, 5 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
Openpgpkey { name, ttl, type, 5 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
PTRRecord { name, ttl, type, 5 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
TXTRecord { name, ttl, type, 5 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Text content for the record. The content must consist of quoted "character strings" (RFC 1035), each with a length of up to 255 bytes. Strings exceeding this allowed maximum length are automatically split.
Learn more at https://www.cloudflare.com/learning/dns/dns-records/dns-txt-record/.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
CAARecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
CERTRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
DNSKEYRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
DSRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
HTTPSRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
LOCRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
NAPTRRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
SMIMEARecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
SRVRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Priority, weight, port, and SRV target. See 'data' for setting the individual component values.
data?: Data { port, priority, target, weight } Components of a SRV record.
Components of a SRV record.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
SSHFPRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
SVCBRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
TLSARecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
URIRecord { name, ttl, type, 7 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
RecordResponse = A { id, created_on, meta, 4 more } | AAAA { id, created_on, meta, 4 more } | CNAME { id, created_on, meta, 4 more } | 18 more
Openpgpkey { id, comment, content, 12 more }
Whether the record is receiving the performance and security benefits of Cloudflare.
settings: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
SMIMEARecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
SRVRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Priority, weight, port, and SRV target. See 'data' for setting the individual component values.
data?: Data { port, priority, target, weight } Components of a SRV record.
Components of a SRV record.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
SSHFPRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
SVCBRecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
TLSARecord { name, ttl, type, 6 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
TXTRecord { name, ttl, type, 5 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Text content for the record. The content must consist of quoted "character strings" (RFC 1035), each with a length of up to 255 bytes. Strings exceeding this allowed maximum length are automatically split.
Learn more at https://www.cloudflare.com/learning/dns/dns-records/dns-txt-record/.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
URIRecord { name, ttl, type, 7 more }
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map.
Whether the record is receiving the performance and security benefits of Cloudflare.
settings?: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
RecordScanReviewResponse { accepts, rejects }
Openpgpkey { id, comment, content, 12 more }
Whether the record is receiving the performance and security benefits of Cloudflare.
settings: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
RecordBatchResponse { deletes, patches, posts, puts }
Openpgpkey { id, comment, content, 12 more }
Whether the record is receiving the performance and security benefits of Cloudflare.
settings: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Openpgpkey { id, comment, content, 12 more }
Whether the record is receiving the performance and security benefits of Cloudflare.
settings: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Openpgpkey { id, comment, content, 12 more }
Whether the record is receiving the performance and security benefits of Cloudflare.
settings: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
Openpgpkey { id, comment, content, 12 more }
Whether the record is receiving the performance and security benefits of Cloudflare.
settings: Settings { ipv4_only, ipv6_only } Settings for the DNS record.
Settings for the DNS record.
Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
DNSSettings
DNSSettingsZone
Show DNS Settings
Update DNS Settings
ModelsExpand Collapse
ZoneGetResponse { flatten_all_cnames, foundation_dns, internal_dns, 6 more }
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.
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.
nameservers: Nameservers { type, ns_set } Settings determining the nameservers through which the zone should be available.
Settings determining the nameservers through which the zone should be available.
Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex.
soa: SOA { expire, min_ttl, mname, 4 more } Components of the zone's SOA record.
Components of the zone's SOA record.
Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone.
The time to live (TTL) for negative caching of records within the zone.
The primary nameserver, which may be used for outbound zone transfers. If null, a Cloudflare-assigned value will be used.
Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated.
Time in seconds after which secondary servers should retry queries after the primary server was unresponsive.
ZoneEditResponse { flatten_all_cnames, foundation_dns, internal_dns, 6 more }
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.
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.
nameservers: Nameservers { type, ns_set } Settings determining the nameservers through which the zone should be available.
Settings determining the nameservers through which the zone should be available.
Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex.
soa: SOA { expire, min_ttl, mname, 4 more } Components of the zone's SOA record.
Components of the zone's SOA record.
Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone.
The time to live (TTL) for negative caching of records within the zone.
The primary nameserver, which may be used for outbound zone transfers. If null, a Cloudflare-assigned value will be used.
Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated.
Time in seconds after which secondary servers should retry queries after the primary server was unresponsive.
DNSSettingsAccount
Show DNS Settings
Update DNS Settings
ModelsExpand Collapse
AccountGetResponse { zone_defaults }
zone_defaults: ZoneDefaults { flatten_all_cnames, foundation_dns, internal_dns, 6 more }
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.
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.
nameservers: Nameservers { type } Settings determining the nameservers through which the zone should be available.
Settings determining the nameservers through which the zone should be available.
Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex.
soa: SOA { expire, min_ttl, mname, 4 more } Components of the zone's SOA record.
Components of the zone's SOA record.
Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone.
The time to live (TTL) for negative caching of records within the zone.
The primary nameserver, which may be used for outbound zone transfers. If null, a Cloudflare-assigned value will be used.
Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated.
Time in seconds after which secondary servers should retry queries after the primary server was unresponsive.
AccountEditResponse { zone_defaults }
zone_defaults: ZoneDefaults { flatten_all_cnames, foundation_dns, internal_dns, 6 more }
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.
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.
nameservers: Nameservers { type } Settings determining the nameservers through which the zone should be available.
Settings determining the nameservers through which the zone should be available.
Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex.
soa: SOA { expire, min_ttl, mname, 4 more } Components of the zone's SOA record.
Components of the zone's SOA record.
Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone.
The time to live (TTL) for negative caching of records within the zone.
The primary nameserver, which may be used for outbound zone transfers. If null, a Cloudflare-assigned value will be used.
Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated.
Time in seconds after which secondary servers should retry queries after the primary server was unresponsive.
DNSSettingsAccountViews
List Internal DNS Views
DNS Internal View Details
Create Internal DNS View
Update Internal DNS View
Delete Internal DNS View
DNSAnalytics
DNSAnalyticsReports
ModelsExpand Collapse
Report { data, data_lag, max, 4 more }
Number of seconds between current time and last processed event, in another words how many seconds of data could be missing.
Maximum results for each metric (object mapping metric names to values). Currently always an empty object.
Minimum results for each metric (object mapping metric names to values). Currently always an empty object.
DNSAnalyticsReportsBytimes
ModelsExpand Collapse
ByTime { data, data_lag, max, 5 more }
Number of seconds between current time and last processed event, in another words how many seconds of data could be missing.
Maximum results for each metric (object mapping metric names to values). Currently always an empty object.
Minimum results for each metric (object mapping metric names to values). Currently always an empty object.
query: Query { dimensions, limit, metrics, 5 more }
DNSZone Transfers
DNSZone TransfersForce AXFR
Force AXFR
DNSZone TransfersIncoming
Secondary Zone Configuration Details
Create Secondary Zone Configuration
Update Secondary Zone Configuration
Delete Secondary Zone Configuration
ModelsExpand Collapse
DNSZone TransfersOutgoing
Primary Zone Configuration Details
Create Primary Zone Configuration
Update Primary Zone Configuration
Delete Primary Zone Configuration
Disable Outgoing Zone Transfers
Enable Outgoing Zone Transfers
Force DNS NOTIFY
DNSZone TransfersOutgoingStatus
Get Outgoing Zone Transfer Status
DNSZone TransfersACLs
ACL Details
Create ACL
Update ACL
Delete ACL
ModelsExpand Collapse
ACL { id, ip_range, name }
Allowed IPv4/IPv6 address range of primary or secondary nameservers. This will be applied for the entire account. The IP range is used to allow additional NOTIFY IPs for secondary zones and IPs Cloudflare allows AXFR/IXFR requests from for primary zones. CIDRs are limited to a maximum of /24 for IPv4 and /64 for IPv6 respectively.
DNSZone TransfersPeers
List Peers
Peer Details
Create Peer
Update Peer
Delete Peer
ModelsExpand Collapse
Peer { id, name, ip, 3 more }
IPv4/IPv6 address of primary or secondary nameserver, depending on what zone this peer is linked to. For primary zones this IP defines the IP of the secondary nameserver Cloudflare will NOTIFY upon zone changes. For secondary zones this IP defines the IP of the primary nameserver Cloudflare will send AXFR/IXFR requests to.
Enable IXFR transfer protocol, default is AXFR. Only applicable to secondary zones.