---
title: "Delete DNS zone"
method: GET
path: "/killdns"
tags: ["DNS", "DNS Zones"]
---

# Delete DNS zone

`GET /killdns`

This function deletes a DNS zone.

**Important:**

- The WHM API 1 adddns function adds an XDNS entry for a domain in the following locations:
 - The `/var/cpanel/users/USER` file, where `USER` represents the domain's owner.
 - The `/etc/vdomainaliases/DOMAIN` directory, where `DOMAIN` represents the new zone's domain.
 - The `/etc/vfilters/DOMAIN` directory, where `DOMAIN` represents the new zone's domain.
- This function does **not** automatically delete these entries. You **must** manually delete these entries, or you **cannot** use this domain as a value in other API functions.
- You cannot delete other DNS zones that reside on *Write-only* servers in a DNS cluster.

**Important:**

When you disable the [DNS role](https://go.cpanel.net/serverroles), the system **disables** this function.

**NOTE:**

You **cannot** use this function to delete temporary domains.

## Query parameters

- `domain` string, domain, required

## Response `200`

HTTP Request was successful.

- object
  - `metadata` object
    - `command` string — The method name called.
    - `output` object
      - `raw` string — The raw response output.
    - `reason` string — The reason the API function failed when the `metadata.result` field is `0`. This field may display a success message when a function succeeds.
    - `result` 0 | 1 — * `1` - Success. * `0` - Failed. Check the `reason` field for more details.
    - `version` integer — The version of the API function.

---

[API](https://skmtc.net/cpanel/apis/whm-api.md) · [All operations](https://skmtc.net/cpanel/apis/whm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/whm-api/revisions/3da41671c02c/schema)