Title: Delete a CNAME Record via API  
PrimaryCategory: DNS  
Type: Procedural  
Tags: CNAME, delete, API, DNS record, domain, HTTP POST  
Source UI Terms: auth-userid, api-key, domain-name, host, value  
Source Reference: Delete a CNAME Record via API  

Prerequisites:
- Have your Live Account Reseller Id (auth-userid).
- Have your API key (api-key).
- Know the domain name from which you want to delete the CNAME record.
- Know the hostname of the CNAME record to delete.
- Know the Fully Qualified Domain Name (FQDN) value of the CNAME record.

Steps:
1) Use the HTTP POST method to send a request to the API endpoint.
2) Form the request URL as:
   ```
   https://test.httpapi.com/api/dns/manage/delete-cname-record.json
   ```
3) Include the following required parameters in the query string:
   - `auth-userid`: your Live Account Reseller Id (integer)
   - `api-key`: your API authentication key (string)
   - `domain-name`: the domain name to target (string)
   - `host`: the hostname of the CNAME record to delete (string)
   - `value`: the Fully Qualified Domain Name of the CNAME record (string)
4) Submit the POST request.

Response Handling:
- On success, the response returns a status of **Success** if the record was deleted or did not exist.
- On failure, the response includes an **error** key with the error description.

Summary:
To delete a CNAME record using the API, send a POST request with your reseller ID, API key, target domain, hostname, and FQDN value. A successful deletion returns a &quot;Success&quot; status; errors include descriptive messages.

Evaluation Pairs:

Q: What HTTP method is used to delete a CNAME record via the API?  
A: The HTTP POST method is used for deleting a CNAME record.

Q: What parameters are required in the API request to delete a CNAME record?  
A: Required parameters are auth-userid, api-key, domain-name, host, and value.

Q: What response indicates the CNAME record was successfully deleted or did not exist?  
A: The response status &quot;Success&quot; indicates the record was deleted or did not exist.

<p>When you want to remove a CNAME record from a domain using the API. This article explains the required parameters, API request format, and response details for deleting CNAME records.</p>
<div class="region region-content">
<div class="hidden"> </div>
<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">Deleting CNAME 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>Deletes a Canonical (CNAME) 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">our 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 delete a CNAME record</td></tr><tr><td colspan="1" rowspan="1">host</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Hostname of the record to be deleted</td></tr><tr><td colspan="1" rowspan="1">value</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">A Fully Qualified Domain Name (FQDN)</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/delete-cname-record.json?auth-userid=0&amp;api-key=key&amp;domain-name=domain.com&amp;host=webmail&amp;value=webmail.domain.com </code></p>
<h2><a name="heading_4"></a>Response</h2>
<p>Returns <em>Success</em> as the status of the response if the record is deleted successfully or record does not exist.</p>
<p>In case of any error, an <em>error</em> key with error description (as value) will be returned.</p>
</div>
</div>
</div>
</div>
<div class="mychild-topics"> </div>
</div>
<div class="seedetailssection"> </div>

When you want to remove a CNAME record from a domain using the API. This article explains the required parameters, API request format, and response details for deleting CNAME records.

Name	Data Type	Required / Optional	Description
auth-userid	Integer	Required	our 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 delete a CNAME record
host	String	Required	Hostname of the record to be deleted
value	String	Required	A Fully Qualified Domain Name (FQDN)