// AI Platform Drift
Cloudflare DNS API adds nameservers.type enum value, deprecates foundation_dns boolean
Cloudflare developer changelog · published 2026-10-26 18:44 UTC
WHAT CHANGEDStarting 2026-10-26, Cloudflare's /zones/{zone_id}/dns_settings and /accounts/{account_id}/dns_settings endpoints represent Advanced Nameservers with nameservers.type: "cloudflare.advanced" instead of foundation_dns: true. The rollout takes seven days. The foundation_dns boolean remains as a deprecated compatibility alias; conflicting values in PATCH requests are rejected. Cloudflare will remove foundation_dns in a future unscheduled API change.
WHY IT MATTERSClients treating nameservers.type as a closed enum will fail to parse responses containing "cloudflare.advanced" during and after the rollout. Code that writes foundation_dns without also setting nameservers.type will work during the transition but will break when the boolean is removed.
WHAT TO DOUpdate DNS settings clients to recognize nameservers.type: "cloudflare.advanced" as a valid enum value before 2026-11-02. For write operations, migrate from foundation_dns to nameservers.type: "cloudflare.advanced". Grep for "foundation_dns" and "nameservers.type" in API client code.
ACT-BY DATE PASSED — this item's act-by date, 2026-11-02, is before this page was generated 2026-11-21 (UTC). Check the primary source before acting on it.
Model-reported confidence 95% (not measured accuracy)
Primary source ↗
written by anthropic/claude-sonnet-4.5
Show the reasoning — raw diff, triage verdict, confidence
RAW DIFF
+## DNS - Advanced Nameservers use a nameserver type +https://developers.cloudflare.com/changelog/post/2026-10-26-foundation-dns-nameserver-type/ +Mon, 26 Oct 2026 00:00:00 GMT + +Starting today, the DNS settings endpoints gradually begin to represent Advanced Nameservers with nameservers.type: "cloudflare.advanced". The rollout is expected to take seven days. Previously, the API used the "foundation_dns": true setting for this configuration. +Before the rollout reaches an account, the endpoints continue to return nameservers.type: "cloudflare.standard" for Advanced Nameservers. The endpoints accept nameservers.type: "cloudflare.advanced" in PATCH requests for entitled accounts throughout the rollout. The zone settings JSON for /zones/{zone_id}/dns_settings is: +{ +"nameservers": { +"type": "cloudflare.advanced" +}, +"foundation_dns": true +} +Cloudflare will make an equivalent change to /accounts/{account_id}/dns_settings at the same time. +The foundation_dns boolean remains available as a deprecated compatibility alias in zone and account-default settings. Use nameservers.type: "cloudflare.advanced" for new writes. +You can continue to read and write foundation_dns during this transition. If a PATCH request includes both values, they must match. The API rejects conflicting values. +Update clients that treat nameservers.type as a closed enum to recognize the "cloudflare.advanced" value. +This API update does not change your Foundation DNS subscription or whether Advanced Nameservers are enabled on your zones. It does not require a zone migration. +In a future API change, Cloudflare will remove the foundation_dns parameter from the API endpoint. After migrating to nameservers.type, remove handling for the boolean from your client.
HOW IT WAS JUDGED
Triage signals below are model-reported assertions, preserved verbatim; they are not independent arithmetic verification.
| triage verdict | MATERIAL at 0.92, needed 0.5 |
|---|---|
| triage reasoning | Breaking API change with deprecation timeline requires client updates before foundation_dns removal. |
| signals | breaking API change: new required field nameservers.type · deprecation path: foundation_dns boolean deprecated, removal planned · rollout timeline: 7-day gradual rollout starting 2026-10-26 · client migration required: enum must recognize new value · API endpoint change: affects /zones/{zone_id}/dns_settings and /accounts/{account_id}/dns_settings · validation rule: conflicting foundation_dns and nameservers.type values rejected |
| suppression | — |
| triage model | anthropic/claude-haiku-4.5 ($0.00000) |
| writer model | anthropic/claude-sonnet-4.5 ($0.00000) |