Remove DNS host

Remove one Namecheap DNS host record from a domain managed through this Vee3 account.

← All Domains endpoints · Capability overview

DELETE/v1/domains/managed/{domain}/dns-hosts/{host_id}

https://api.vee3.io/v1/domains/managed/{domain}/dns-hosts/{host_id}

5 tokens

Remove one Namecheap DNS host record from a domain managed through this Vee3 account.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

domains.remove_dns_host

Parameters2 fields

domainstringRequired

Managed domain name (for example example.com).

host_idstringRequired

Host record id from domains.get_dns_hosts.

Response9 fields

domainstring

Managed domain name.

is_using_namecheap_dnsboolean

Whether the domain currently uses Namecheap DNS.

hostsarrayitems

6 fields

Full DNS host list after the removal.

host_idstring

Namecheap host record id.

host_namestring

Host label, for example @ or www.

record_typestring

DNS record type.

addressstring

Record value.

mx_prefstring

MX preference when record_type is MX or MXE.

ttlinteger

TTL in seconds.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, domains_not_configured, domains_upstream_error, domain_not_found, dns_host_not_found, dns_not_using_namecheap

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/managed/{domain}/dns-hosts/{host_id}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
payload = {
    "domain": "my-new-site.com",
    "host_id": "124"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Host list after removing one record.

hosts_after_remove.json

{
  "domain": "my-new-site.com",
  "is_using_namecheap_dns": true,
  "hosts": [
    {
      "host_id": "123",
      "host_name": "@",
      "record_type": "A",
      "address": "203.0.113.10",
      "mx_pref": null,
      "ttl": 1800
    }
  ]
}