Title: Modify TXT Records Using the API
PrimaryCategory: DNS
Type: Procedural
Tags: TXT record, DNS, API, update, TTL
Source UI Terms: auth-userid, api-key, domain-name, host, current-value, new-value, ttl, status, Success, ERROR
Source Reference: Modify TXT Records Using the API

Prerequisites:
- Obtain your Live Account Reseller Id (auth-userid).
- Obtain your API key (api-key).
- Know the domain name for which the TXT record will be modified.
- Know the current TXT value you want to change.
- Decide the new TXT value to update.
- (Optional) Determine the TTL value in seconds if you want to override the default.

Steps:
1) Prepare a POST API request to the endpoint `/api/dns/manage/update-txt-record.json`.
2) Include the following required parameters in the query string or request body:
   - `auth-userid`: Your reseller account ID (integer).
   - `api-key`: Your authentication API key (string).
   - `domain-name`: The domain whose TXT record you want to modify (string).
   - `current-value`: The existing TXT record value you want to replace (string).
   - `new-value`: The new TXT record value you want to set (string).
3) Optionally, include:
   - `host`: The host portion for which to modify the TXT record (string). For example, use `www` to modify the TXT record for `www.domainname.com`.
   - `ttl`: The TTL (time to live) in seconds for DNS caching (integer). Defaults to 14400 if not specified.
4) Send the POST request.
5) Check the response:
   - If the `status` key value is **Success**, the TXT record was modified successfully.
   - If the `status` is **ERROR**, review the error message for troubleshooting.

Warnings:
- Ensure that the current TXT value matches exactly for the record modification to succeed.
- Modifying DNS records may take time to propagate.

Summary:
You can update a domain&#39;s TXT DNS record by sending a POST request to the API with your reseller ID, API key, domain name, current TXT value, new TXT value, and optional host and TTL parameters. A successful response confirms the TXT record was modified.

Evaluation Pairs:
Q: What API parameters are required to modify a TXT record?
A: You must provide auth-userid, api-key, domain-name, current-value, and new-value.

Q: How can I specify the subdomain host for the TXT record modification?
A: Use the optional `host` parameter with the host part, such as `www` for www.domainname.com.

Q: What does the API response indicate if the TXT record modification fails?
A: It returns a status key with value ERROR along with an error message.

<p>When you want to update a Text (TXT) DNS record. This article explains how to modify TXT records for a domain using the API, including host values, TXT content 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">
<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 Text (TXT) 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">Your Live Account Reseller Id</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">An alphanumeric code that can be used to authenticate your API calls</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 TXT 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 a TXT record</p>
<p><span class="underline">Example</span>:</p>
<p>You may send this as <em>www</em>, if u wish to modify the TXT record for <a href="https://www.domainname.com" target="_blank">www.domainname.com</a>.</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 TXT 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 TXT 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-txt-record.json?auth-userid=0&amp;api-key=key&amp;domain-name=domain.asia&amp;current-value=Mail Server&amp;new-value=Chat Server </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 Text (TXT) DNS record. This article explains how to modify TXT records for a domain using the API, including host values, TXT content changes, and TTL configuration.

Name	Data Type	Required / Optional	Description
auth-userid	Integer	Required	Your Live Account Reseller Id
api-key	String	Required	An alphanumeric code that can be used to authenticate your API calls
domain-name	String	Required	Domain name for which you want to modify the TXT record
host	String	Optional	The host part of the domain-name for which you need to modify a TXT record Example: You may send this as www, if u wish to modify the TXT record for www.domainname.com.
current-value	String	Required	Current TXT value
new-value	String	Required	New TXT value
ttl	Integer	Optional	Number of seconds the record needs to be cached by the DNS Resolvers. Default value is 14400.