---
title: "Delete custom domain"
method: DELETE
path: "/api/apps/{app_id}/custom-domains/{domain_id}"
---

# Delete custom domain

`DELETE /api/apps/{app_id}/custom-domains/{domain_id}`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Removes a custom domain from the app and stops serving it.

This detaches the domain from Base44's hosting, deletes any email domain configured on it, and stops it serving your app. Other domains that were redirecting to this one stop redirecting.

Deleting is permanent and there's no undo. The domain itself isn't affected at your registrar, so you can point it somewhere else afterwards, but its Base44 configuration is removed. To stop serving a domain while keeping it attached, use [Unlink custom domain](/api-reference/unlink-custom-domain) instead.

A failed delete can still take the domain out of service. Base44 detaches it from hosting and removes its email domain first, so a failure after that point leaves a domain that no longer works but still appears in [List custom domains](/api-reference/list-custom-domains). Retrying is safe and is how you finish the job. If the domain has already been deleted, the retry reports it as missing.

## Path parameters

- `app_id` string, required — ID of the app the domain belongs to.
- `domain_id` string, required — ID of the custom domain. Get this from [List custom domains](/api-reference/list-custom-domains).

## Response `200`

The domain is deleted.

- DomainMessageResponse — A one-line confirmation.
  - `message` string, required — What happened, in plain text.

## Other responses

- `400` — The domain could not be detached from Base44's hosting. The domain is left attached, so retry.
- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app, or you used a workspace API key. These endpoints take a personal API key.
- `404` — The app has no custom domain with this ID, or the app doesn't exist.

## Changes

- **2026-08-30** `394136a6cdd4` — 1 info
  - removed the non-success response with the status `422`
- **2026-08-26** `f2727732ced1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/apps/:app_id/custom-domains/:domain_id/delete.md)

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idealspot/base44-app-management-api/revisions/6ad855bf424f/schema)