---
title: "Delete a custom domain"
method: DELETE
path: "/api/v1/domains/{id}"
tags: ["Domains"]
---

# Delete a custom domain

`DELETE /api/v1/domains/{id}`

## Request

- Base URL: `https://cooperemail.com`
- URL: `https://cooperemail.com/api/v1/domains/{id}`
- Auth: HTTP bearer

Removes the domain. When dns.mode is automatic, deletes only the DNS records Cooper wrote. Returns dns_cleanup. Another account's id is 404 domain_not_found.

## Path parameters

- `id` string, required

## Response `200`

Deleted

- DomainDelete
  - `id` string, required
  - `deleted` true, required
  - `dns_cleanup` object, required
    - `removed` string[], required
    - `errors` string[], required

## Other responses

- `404`: domain_not_found

---

[API](https://skmtc.dev/cooperemail/apis/cooper-email-api.md) · [All operations](https://skmtc.dev/cooperemail/apis/cooper-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cooperemail/apis/cooper-email-api/revisions/6d800a7b3e33?raw)