---
title: "Remove a custom domain"
method: DELETE
path: "/sites/{siteId}/custom-domains/{id}"
tags: ["Custom Domains"]
---

# Remove a custom domain

`DELETE /sites/{siteId}/custom-domains/{id}`

## Request

- Base URL: `https://api.nippy.host`
- URL: `https://api.nippy.host/sites/{siteId}/custom-domains/{id}`
- Auth: `bearer` (a scheme the document does not define)

Deletes the Cloudflare Custom Hostname, the KV record, and the local row. Cascades to the auto-attached `www.` companion if present.

## Path parameters

- `siteId` string, required
- `id` string, required

## Response `204`

## Other responses

- `401`: Not authenticated
- `403`: You do not own this site
- `404`: Site or custom domain not found

---

[API](https://skmtc.dev/nippy/apis/nippy-backend-api.md) · [All operations](https://skmtc.dev/nippy/apis/nippy-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nippy/apis/nippy-backend-api/revisions/7ab23f040a55?raw)