> ## Documentation Index
> Fetch the complete documentation index at: https://docs.namegrid.org/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE /v1/domains/{domain}/dns/{id} — Delete DNS Record

> DELETE /v1/domains/{domain}/dns/{recordId} — Permanently delete a DNS record by its ID. Returns success confirmation on removal.

Use this endpoint to permanently remove a DNS record from a domain. You'll need the opaque `id` returned when the record was created or listed. Once deleted, the record is gone — there is no way to recover it, and any traffic that relied on it (such as subdomain routing or mail delivery) will immediately be affected once the change propagates through DNS.

## Endpoint

**DELETE** `/v1/domains/{domain}/dns/{recordId}`

## Path Parameters

<ParamField path="domain" type="string" required>
  The domain name the record belongs to (e.g. `example.com`).
</ParamField>

<ParamField path="recordId" type="string" required>
  The opaque record identifier returned by the [list](/api-reference/dns/list) or [create](/api-reference/dns/create) endpoints.
</ParamField>

## Request Example

```bash theme={null}
curl -X DELETE https://api.namegrid.org/v1/domains/example.com/dns/b6b0b6a2-... \
  -H "x-api-key: ng_live_xxxxxxxxxxxxxxxxxxxxxxxx"
```

## Response

**200 OK**

<ResponseField name="success" type="boolean">
  `true` when the record has been successfully deleted.
</ResponseField>

```json theme={null}
{ "success": true }
```

## Errors

| Status | Description                                                |
| ------ | ---------------------------------------------------------- |
| `404`  | No record with the given `recordId` exists on this domain. |

<Warning>
  DNS record deletion is permanent and cannot be undone. Before deleting, make sure no active services (web routing, email, domain verification, etc.) depend on the record you're removing.
</Warning>