Title: Modify NS Records Using the API  
PrimaryCategory: DNS  
Type: Procedural  
Tags: ns_record, api, dns_update, ttl, domain_dns  
Source UI Terms: auth-userid, api-key, domain-name, host, current-value, new-value, ttl  
Source Reference: Modify NS Records Using the API  

---

Prerequisites:  
- Have valid API credentials: auth-userid (integer) and api-key (string).  
- Know the domain name for which to modify the NS record.  
- Know the current NS record value.  
- Determine the new NS record value to update to.  

Steps:  
1) Construct a POST API request to the endpoint:  
   `https://test.httpapi.com/api/dns/manage/update-ns-record.json`  
2) Include the following parameters in the request query or body:  
   - `auth-userid` (Integer, Required): Your authentication user ID.  
   - `api-key` (String, Required): Your API key for authentication.  
   - `domain-name` (String, Required): The domain name whose NS record you want to modify.  
   - `current-value` (String, Required): The existing NS value to be replaced.  
   - `new-value` (String, Required): The new NS value to set.  
   - `host` (String, Optional): The host part of the domain name if modifying a subdomain NS record (e.g., &quot;ns1&quot; for ns1.domainname.com).  
   - `ttl` (Integer, Optional): Time to Live in seconds for caching by DNS resolvers; default is 14400 seconds if omitted.  
3) Send the POST request to update the NS record.  
4) Check the response for a key `status`:  
   - If the value is `Success`, the NS record was modified successfully.  
   - If the value is `ERROR`, review the accompanying error message to diagnose the problem.  

Warnings:  
- Ensure the `current-value` exactly matches the existing NS record or the update will fail.  
- TTL values should be set carefully as they affect DNS caching behavior.  
- Incorrect NS record changes may disrupt domain name resolution.  

Summary:  
You can use the POST API endpoint to update a domain&#39;s NS record by providing your authentication credentials, the domain name, current and new NS values, and optionally the host and TTL value. A success status confirms the update.  

Evaluation Pairs:  
Q: What parameters are required to modify an NS record using the API?  
A: Required parameters are auth-userid, api-key, domain-name, current-value, and new-value.  

Q: How do I specify the subdomain or host when modifying an NS record?  
A: Use the optional `host` parameter with the host part, for example, &quot;ns1&quot; for ns1.domainname.com.  

Q: What does the response status &quot;ERROR&quot; indicate?  
A: It indicates the modification failed; an error message will accompany it explaining the issue.

<p>When you want to update a Name Server (NS) DNS record. This article explains how to modify NS records for a domain using the API, including host values, name server changes, and TTL configuration.</p>
<div class="region region-content">
<div class="block block-core block-page-title-block" id="block-twostates-page-title">
<div class="content">
<h1 class="title page-title"><span class="field field--name-title field--type-string field--label-hidden">Modifying NS Record</span></h1>
<div id="toc" style="display: block;">
<div id="toc_content">
<p> </p>
</div>
</div>
</div>
</div>
<div class="node__content clearfix">
<div class="layout layout--onecol">
<div class="layout__region layout__region--content">
<div class="clearfix text-formatted field field--name-body field--type-text-with-summary field--label-hidden field__item">
<h2><a name="heading_0"></a>Description</h2>
<p>Modifies a Name Server (NS) record.</p>
<h2><a name="heading_1"></a>Parameters</h2>
<table class="codetable"><tbody><tr><th colspan="1" rowspan="1">Name</th><th colspan="1" rowspan="1">Data Type</th><th colspan="1" rowspan="1">Required / Optional</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">auth-userid</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Authentication Parameter</td></tr><tr><td colspan="1" rowspan="1">api-key</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Authentication Parameter</td></tr><tr><td colspan="1" rowspan="1">domain-name</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Domain name for which you want to modify the NS record</td></tr><tr><td colspan="1" rowspan="1">host</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Optional</td><td colspan="1" rowspan="1">
<p>The host part of the domain-name for which you need to modify the NS record</p>
<p><span class="underline">Example</span>:</p>
<p>You may send this as <em>ns1</em>, if u wish to modify the NS record as ns1.domainname.com.</p>
</td></tr><tr><td colspan="1" rowspan="1">current-value</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Current NS value</td></tr><tr><td colspan="1" rowspan="1">new-value</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">New NS value</td></tr><tr><td colspan="1" rowspan="1">ttl</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Optional</td><td colspan="1" rowspan="1">Number of seconds the record needs to be cached by the DNS Resolvers. Default value is 14400.</td></tr></tbody></table>
<h2><a name="heading_2"></a>HTTP Method</h2>
<p>POST</p>
<h2><a name="heading_3"></a>Example Test URL Request</h2>
<p><code>https://test.httpapi.com/api/dns/manage/update-ns-record.json?auth-userid=0&amp;api-key=key&amp;domain-name=domain.asia&amp;current-value=ns1.domain.com&amp;new-value=ns2.domain.com </code></p>
<h2><a name="heading_4"></a>Response</h2>
<p>Returns a <strong>status</strong> key with value as <em>Success</em> if the record is modified successfully.</p>
<p>In case of any errors, a <strong>status</strong> key with value as <em>ERROR</em> alongwith an error message will be returned.</p>
</div>
</div>
</div>
</div>
<div class="mychild-topics"> </div>
</div>
<div class="seedetailssection"> </div>

When you want to update a Name Server (NS) DNS record. This article explains how to modify NS records for a domain using the API, including host values, name server changes, and TTL configuration.

Name	Data Type	Required / Optional	Description
auth-userid	Integer	Required	Authentication Parameter
api-key	String	Required	Authentication Parameter
domain-name	String	Required	Domain name for which you want to modify the NS record
host	String	Optional	The host part of the domain-name for which you need to modify the NS record Example: You may send this as ns1, if u wish to modify the NS record as ns1.domainname.com.
current-value	String	Required	Current NS value
new-value	String	Required	New NS value
ttl	Integer	Optional	Number of seconds the record needs to be cached by the DNS Resolvers. Default value is 14400.