{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Update DNS settings for an account","properties":{"path":{"type":"object","properties":{"account_id":{"$ref":"#/definitions/dns-settings_identifier"}},"required":["account_id"],"additionalProperties":false},"body":{"$ref":"#/definitions/dns-settings_account_settings_patch"}},"required":["path","body"],"additionalProperties":false,"definitions":{"dns-settings_identifier":{"description":"Identifier.","type":"string","maxLength":32,"examples":["023e105f4ecef8ad9ca31a8372d0c353"]},"dns-settings_account_settings_patch":{"type":"object","properties":{"enforce_dns_only":{"$ref":"#/definitions/dns-settings_enforce_dns_only"},"zone_defaults":{"$ref":"#/definitions/dns-settings_dns-settings-account-patch"}}},"dns-settings_enforce_dns_only":{"description":"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](https://developers.cloudflare.com/dns/proxy-status/enforce-dns-only).","type":"boolean","examples":[false]},"dns-settings_dns-settings-account-patch":{"description":"Default settings for new zones created in this account.","type":"object","allOf":[{"$ref":"#/definitions/dns-settings_dns-settings-patch"},{"properties":{"nameservers":{"description":"Settings determining the nameservers through which the zone should be available.","type":"object","properties":{"type":{"description":"Nameserver type","type":"string","enum":["cloudflare.standard","cloudflare.advanced","cloudflare.standard.random","custom.account","custom.tenant"],"examples":["cloudflare.standard"]}}}},"type":"object"}]},"dns-settings_dns-settings-patch":{"type":"object","allOf":[{"$ref":"#/definitions/dns-settings_dns-settings-base"}]},"dns-settings_dns-settings-base":{"type":"object","properties":{"flatten_all_cnames":{"$ref":"#/definitions/dns-settings_flatten_all_cnames"},"foundation_dns":{"$ref":"#/definitions/dns-settings_foundation_dns"},"internal_dns":{"$ref":"#/definitions/dns-settings_internal_dns_base"},"multi_provider":{"$ref":"#/definitions/dns-settings_multi_provider"},"ns_ttl":{"$ref":"#/definitions/dns-settings_ns_ttl"},"secondary_overrides":{"$ref":"#/definitions/dns-settings_secondary_overrides"},"soa":{"$ref":"#/definitions/dns-settings_soa-base"},"zone_mode":{"$ref":"#/definitions/dns-settings_zone_mode"}}},"dns-settings_flatten_all_cnames":{"description":"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.","type":"boolean","examples":[false]},"dns-settings_foundation_dns":{"description":"Deprecated. Use nameservers.type to configure Advanced Nameservers.","type":"boolean","examples":[false]},"dns-settings_internal_dns_base":{"description":"Settings for this internal zone.","type":"object","properties":{"reference_zone_id":{"description":"The ID of the zone to fallback to.","type":"string","examples":[{"description":"Identifier.","example":"023e105f4ecef8ad9ca31a8372d0c353","maxLength":32,"type":"string","x-auditable":true}]}}},"dns-settings_multi_provider":{"description":"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.","type":"boolean","examples":[false]},"dns-settings_ns_ttl":{"description":"The time to live (TTL) of the zone's nameserver (NS) records.","type":"number","maximum":86400,"minimum":30,"examples":[86400]},"dns-settings_secondary_overrides":{"description":"Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex.","type":"boolean","examples":[false]},"dns-settings_soa-base":{"description":"Components of the zone's SOA record.","type":"object","properties":{"expire":{"description":"Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone.","type":"number","maximum":2419200,"minimum":86400,"examples":[604800]},"min_ttl":{"description":"The time to live (TTL) for negative caching of records within the zone.","type":"number","maximum":86400,"minimum":60,"examples":[1800]},"mname":{"description":"The primary nameserver, which may be used for outbound zone transfers. If null, a Cloudflare-assigned value will be used.","type":["string","null"],"examples":["kristina.ns.cloudflare.com"]},"refresh":{"description":"Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated.","type":"number","maximum":86400,"minimum":600,"examples":[10000]},"retry":{"description":"Time in seconds after which secondary servers should retry queries after the primary server was unresponsive.","type":"number","maximum":86400,"minimum":600,"examples":[2400]},"rname":{"description":"The email address of the zone administrator, with the first label representing the local part of the email address.","type":"string","examples":["admin.example.com"]},"ttl":{"description":"The time to live (TTL) of the SOA record itself.","type":"number","maximum":86400,"minimum":300,"examples":[3600]}}},"dns-settings_zone_mode":{"description":"Whether the zone mode is a regular or CDN/DNS only zone.","type":"string","enum":["standard","cdn_only","dns_only"],"examples":["dns_only"]}}},"name":"Update DNS Settings","id":"cloudflare.dns-settings-for-an-account-update-dns-settings","example":{"path":{"account_id":"023e105f4ecef8ad9ca31a8372d0c353"},"body":{}},"maxRequests":1,"summary":false}}