---
title: "Unlink custom domain"
method: POST
path: "/api/apps/{app_id}/custom-domains/{domain_id}/unlink"
---

# Unlink custom domain

`POST /api/apps/{app_id}/custom-domains/{domain_id}/unlink`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/unlink`
- Auth: HTTP bearer

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

Stops serving the domain, keeping it attached to the app.

Any email domain on it is disabled, and other domains redirecting to this one stop redirecting. The domain stays attached to the app and keeps its redirect target, so [Link custom domain](/api-reference/link-custom-domain) puts it back into service. To remove it altogether, use [Delete custom domain](/api-reference/delete-custom-domain).

A successful call doesn't guarantee the domain has stopped working. Base44 also has to remove it from the system that routes visitors to your app, and that step can fail without failing the call. Nothing in the response reports it, so check the domain in a browser, and unlink again if it still serves the app.

## 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 no longer served.

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

## Other responses

- `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

> 58 revisions in range; 1 not diffed.

- **2026-10-12** `5e139db2e643`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/custom-domains/:domain_id/unlink/post.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)