---
title: "DELETE /api/v1/docs-sites/{spaceId}/custom-domain"
method: DELETE
path: "/api/v1/docs-sites/{spaceId}/custom-domain"
---

# DELETE /api/v1/docs-sites/{spaceId}/custom-domain

`DELETE /api/v1/docs-sites/{spaceId}/custom-domain`

## Request

- Base URL: `https://falconer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://falconer.com/api/v1/docs-sites/{spaceId}/custom-domain`
- Auth: none declared

## Path parameters

- `spaceId` integer, required: Space id, from GET /spaces.

## Headers

- `x-organization-id` string: Required when using OAuth bearer tokens.

## Response `200`

The site without its domain.

- DocsCustomDomain
  - `customDomain` string, nullable, required
  - `mode` 'host' | 'path', nullable, required: host: point a CNAME at cnameTarget. path: proxy the path to proxyTarget yourself.
  - `status` 'none' | 'pending' | 'ready' | 'active' | 'suspended' | 'removing' | 'failed', required
  - `validation` object, nullable, required: DNS record that proves you own a host-mode domain.
    - `name` string, required
    - `value` string, required
  - `cnameTarget` string, required
  - `proxyTarget` object, nullable, required
    - `host` string, required
    - `basePath` string, required
  - `edgeSettling` boolean, required: The live site is still moving to its new address.
  - `addonsPending` boolean, required: An enable or disable is still being applied.

## Other responses

- `400`: Bad request
- `402`: Not enough credits for the custom domain add-on
- `403`: Public docs are not enabled or permission is missing
- `404`: Docs site or build not found
- `409`: The site changed or the domain is in use
- `412`: Verify, disable, or remove the current domain first
- `503`: CloudFront is still working on the domain; retry

---

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