---
title: "Remove DNS Record"
method: DELETE
path: "/v1/domains/{domain}/dns-records/{recordId}"
tags: ["Domains"]
---

# Remove DNS Record

`DELETE /v1/domains/{domain}/dns-records/{recordId}`

## Request

- Base URL: `https://api.migma.ai`
- URL: `https://api.migma.ai/v1/domains/{domain}/dns-records/{recordId}`
- Auth: API key in header `Authorization`

Remove a DNS record that was added to a domain bought in Migma. Only removes records the user added, never Migma's own sending records. Requires API key with domain:write permission.

## Path parameters

- `domain` string, required
- `recordId` string, required

## Response `200`

DNS record removed

- ApiResponseDnsRecordRemoved
  - `success` boolean, required
  - `data` object, nullable
    - `ok` boolean, required
  - `error` string, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - Missing required permissions or access denied
- `404`: Resource not found

## Changes

- **2026-08-22** `2d06ad0e0bc3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/migma/apis/migma-ai-api-v1/changes/v1/domains/:domain/dns-records/:recordId/delete.md)

---

[API](https://skmtc.dev/migma/apis/migma-ai-api-v1.md) - [All operations](https://skmtc.dev/migma/apis/migma-ai-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/migma/apis/migma-ai-api-v1/revisions/2ce0e1e4d856?raw)