--- title: API Queries - Update DNS description: API Queries - Update DNS --- [Skip to content](https://support.above.com/api-queries-update-dns-r#main-content) ![above-logo-466-1](https://support.above.com/hs-fs/hubfs/above-logo-466-1.png?width=230&height=43&name=above-logo-466-1.png) - [Buy Domains](https://www.above.com/marketplace/index.html) - [Sell Domains](https://www.above.com/sell-my-domains.html) - [Monetize](https://www.above.com/monetization.html) - [Register](https://www.above.com/registrar/index.html) - About Show submenu for About - [About Us](https://www.above.com/about.html) - [Above & Beyond Club](https://www.above.com/above-beyond-club.html) - [Brokerage](https://www.above.com/domain-brokerage.html) - [Contact Us](https://www.above.com/contact.html) - [Our Team](https://www.above.com/our-team.html) - [Log In](https://www.above.com/login.html) Open main navigation Close main navigation - [Buy Domains](https://www.above.com/marketplace/index.html) - [Sell Domains](https://www.above.com/sell-my-domains.html) - [Monetize](https://www.above.com/monetization.html) - [Register](https://www.above.com/registrar/index.html) - About Show submenu for About - [About Us](https://www.above.com/about.html) - [Above & Beyond Club](https://www.above.com/above-beyond-club.html) - [Brokerage](https://www.above.com/domain-brokerage.html) - [Contact Us](https://www.above.com/contact.html) - [Our Team](https://www.above.com/our-team.html) - [Log In](https://www.above.com/login.html) How can we help you? - There are no suggestions because the search field is empty. 1. [Above.com FAQ](https://support.above.com/?hsLang=en) 2. [Portfolio Manager Manual](https://support.above.com/portfolio-manager-manual?hsLang=en) 3. [Registrar API](https://support.above.com/portfolio-manager-manual?hsLang=en#registrar-api) # API Queries - Update DNS The update\_dns API function updates the nameservers for a domain. You need to specify at least two nameservers and a maximum of four. Additional parameters are required for this function. #### **Additional Parameters** - domain - Domain name to updated. Note: http://www. should not be included. - dns - New nameservers, seperated by commas (,). You need to specify at least two nameservers and a maximum of four. Your API key is required and all values should be correctly URL encoded. #### **Example** In the below example, we will update the nameservers for "oranges.com" to "ns1.abovedomains.com" and "ns2.abovedomains.com" (domain=oranges.com&dns=ns1.abovedomains.com,ns2.abovedomains.com). #### **Query** https://www.above.com/registrar/api/query.html?key=APIKEY&query=update\_dns&domain=oranges.com&dns=ns1.abovedomains.com,ns2.abovedomains.com #### **Response** \             #### **Example 2** There are various possible errors when updating nameservers for a domain. In this example, we will attempt to update nameservers for "oranges.com" to just "ns1.abovedomains.com" (domain=oranges.com&dns=ns1.abovedomains.com). As we have not specified at least two nameservers, the request will fail. #### **Query** https://www.above.com/registrar/api/query.html?key=APIKEY&query=update\_dns&domain=oranges.com&dns=ns1.abovedomains.com #### **Response** \              \Invalid number of DNS servers specified\             \             #### **Error Codes** Possible error responses for this function are: - [509 - Specified domain is not in your account](https://www.above.com/manual/api/reg/api-manual-error-codes.html#509) - [510 - Domain not specified or invalid domain](https://www.above.com/manual/api/reg/api-manual-error-codes.html#510) - [512 - Domain extension must be specified](https://www.above.com/manual/api/reg/api-manual-error-codes.html#512) - [514 - Domain is pending update or registrar/registry locked](https://www.above.com/manual/api/reg/api-manual-error-codes.html#514) - [1301 - Invalid DNS servers specified. Cannot update DNS](https://www.above.com/manual/api/reg/api-manual-error-codes.html#1301) - [1303 - Invalid number of DNS servers specified](https://www.above.com/manual/api/reg/api-manual-error-codes.html#1303) - [1304 - Please provide DNS servers](https://www.above.com/manual/api/reg/api-manual-error-codes.html#1304) - [1305 - Use two different DNS servers](https://www.above.com/manual/api/reg/api-manual-error-codes.html#1305) - [1306 - Update DNS not allowed on expired domain](https://www.above.com/manual/api/reg/api-manual-error-codes.html#1306) - [1307 - Custom DNS function disabled](https://www.above.com/manual/api/reg/api-manual-error-codes.html#1307) - General errors, such as [401 - Invalid API key](https://www.above.com/manual/api/reg/api-manual-error-codes.html#401) or [500 - System unavailable](https://www.above.com/manual/api/reg/api-manual-error-codes.html#500). For a complete list of error responses, see the [Error Codes manual page](https://www.above.com/manual/api/reg/api-manual-error-codes.html). - [Above.com Help Guides](https://support.above.com/above-com-help-guides?hsLang=en) - [Monetization FAQs](https://support.above.com/monetization-faqs?hsLang=en#main-content) - [Getting Started](https://support.above.com/monetization-faqs?hsLang=en#getting-started) - [Above Maximizer](https://support.above.com/monetization-faqs?hsLang=en#above-maximizer) - [Account Maintenance](https://support.above.com/monetization-faqs?hsLang=en#account-maintenance) - [Getting Paid](https://support.above.com/monetization-faqs?hsLang=en#getting-paid) - [Stats and Reports](https://support.above.com/monetization-faqs?hsLang=en#stats-and-reports) - [Monetization & Portfolio Manager API](https://support.above.com/monetization-faqs?hsLang=en#monetization-portfolio-manager-api) - [Other Questions](https://support.above.com/monetization-faqs?hsLang=en#other-questions) - [Marketplace FAQs](https://support.above.com/marketplace-faqs?hsLang=en#main-content) - [Selling](https://support.above.com/marketplace-faqs?hsLang=en#selling) - [Buying](https://support.above.com/marketplace-faqs?hsLang=en#buying) - [Other](https://support.above.com/marketplace-faqs?hsLang=en#other) - [Registrar FAQs](https://support.above.com/registrar-faqs?hsLang=en#main-content) - [Registration](https://support.above.com/registrar-faqs?hsLang=en#registration) - [Transfer](https://support.above.com/registrar-faqs?hsLang=en#transfer) - [DNS](https://support.above.com/registrar-faqs?hsLang=en#dns) - [Verification](https://support.above.com/registrar-faqs?hsLang=en#verification) - [Two Step Authentication](https://support.above.com/registrar-faqs?hsLang=en#two-step-authentication) - [API](https://support.above.com/registrar-faqs?hsLang=en#api) - [Other](https://support.above.com/registrar-faqs?hsLang=en#other) - [Portfolio Manager FAQs](https://support.above.com/portfolio-manager-faqs?hsLang=en#main-content) - [Features](https://support.above.com/portfolio-manager-faqs?hsLang=en#features) - [Account Maintenance](https://support.above.com/portfolio-manager-faqs?hsLang=en#account-maintenance) - [Stats and Reports](https://support.above.com/portfolio-manager-faqs?hsLang=en#stats-and-reports) - [Monetization & Portfolio Manager API](https://support.above.com/portfolio-manager-faqs?hsLang=en#monetization-portfolio-manager-api) - [Domain Consolidate](https://support.above.com/portfolio-manager-faqs?hsLang=en#domain-consolidate) - [Other](https://support.above.com/portfolio-manager-faqs?hsLang=en#other) - [Portfolio Manager Manual](https://support.above.com/portfolio-manager-manual?hsLang=en#main-content) - [Introduction](https://support.above.com/portfolio-manager-manual?hsLang=en#introduction) - [Interface](https://support.above.com/portfolio-manager-manual?hsLang=en#interface) - [Portfolio Manager](https://support.above.com/portfolio-manager-manual?hsLang=en#portfolio-manager) - [Sell Domains](https://support.above.com/portfolio-manager-manual?hsLang=en#sell-domains) - [Offers Received](https://support.above.com/portfolio-manager-manual?hsLang=en#offers-received) - [Registrar](https://support.above.com/portfolio-manager-manual?hsLang=en#registrar) - [Monetization API](https://support.above.com/portfolio-manager-manual?hsLang=en#monetization-api) - [Registrar API](https://support.above.com/portfolio-manager-manual?hsLang=en#registrar-api) - [My Account Manual](https://support.above.com/portfolio-manager-manual?hsLang=en#my-account-manual) - [Column Descriptions](https://support.above.com/portfolio-manager-manual?hsLang=en#column-descriptions) - [Domain Details](https://support.above.com/portfolio-manager-manual?hsLang=en#domain-details) - [Supported Domains (TLDs)](https://support.above.com/portfolio-manager-manual?hsLang=en#supported-domains-tlds) - [Support and Help](https://support.above.com/portfolio-manager-manual?hsLang=en#support-and-help) - [Monetization Quick-Start Guide](https://support.above.com/monetization-quick-start-guide?hsLang=en) [![Above.com Logo](https://support.above.com/hs-fs/hubfs/above-logo-466.png?width=466&height=88&name=above-logo-466.png "Above.com Logo")](https://www.above.com) [mailto:email@email.com](mailto:email@email.com) Copyright © 2026, Trillion Pty Ltd Domain Registrar [Register Domains](https://www.above.com/registrar/index.html) [Pricing](https://www.above.com/registrar/domain-pricing.html) [FAQs](https://www.above.com/registrar/faq.html) [Dispute Policy](https://www.above.com/registrar/domain-dispute-policy.html) [Terms of Service](https://www.above.com/terms-of-service.html#Above.com_Registrar_Terms) [WHOIS](https://www.above.com/registrar/whois.html) Marketplace [Sell My Domains](https://www.above.com/sell-my-domains.html) [Buy Domains](https://www.above.com/marketplace/index.html) [Escrow](https://www.above.com/marketplace/escrow.html) [FAQs](https://www.above.com/marketplace/faq.html) [Terms of Service](https://www.above.com/terms-of-service.html#Above.com_Marketplace_Terms) Monetization [Monetization](https://www.above.com/monetization.html) [Reporting](https://www.above.com/reporting.html) [FAQs](https://www.above.com/faq.html) [Terms of Service](https://www.above.com/terms-of-service.html#Above.com_MAP_Terms) Brokerage [Domain Brokerage](https://www.above.com/domain-brokerage.html) [Sell a Domain](https://www.above.com/domain-brokerage.html#sell-domain) [Buy a Domain](https://www.above.com/domain-brokerage.html#buy-domain) [How It Works](https://www.above.com/domain-brokerage.html#how-it-works) [Meet the Brokers](https://www.above.com/domain-brokerage.html#broker-team) Above/Support [Contact Us](https://www.above.com/contact.html) [About Us](https://www.above.com/about.html) [Our Team](https://www.above.com/our-team.html) [Above & Beyond Club](https://www.above.com/above-beyond-club.html) [Careers](https://www.trillion.com/careers.html) [Blog](https://www.above.com/blog/) [Site Map](https://www.above.com/sitemap.html) Socials [LinkedIn](https://www.linkedin.com/company/abovedomain/) [X.com](https://twitter.com/above_domain) [Facebook](https://www.facebook.com/above.domain) [Instagram](https://www.instagram.com/above_com) Accreditations - ![](https://www.above.com/img/icann_logo.png) - ![](https://www.above.com/img/auda-logo-black.png) - ![](https://www.above.com//img/iso_black.png) Copyright © 2008 - Above.com Pty Ltd - All rights reserved. [Privacy Policy](https://www.above.com/privacy-policy.html)