Delete custom domain

<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 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. Retrying is safe and is how you finish the job. If the domain has already been deleted, the retry reports it as missing.

delete/api/apps/{app_id}/custom-domains/{domain_id}

Path parameters

app_idstring required

ID of the app the domain belongs to.

ID of the app the domain belongs to.

domain_idstring required

ID of the custom domain. Get this from List custom domains.

ID of the custom domain. Get this from List custom domains.

Response

The domain is deleted.

messagestring required

What happened, in plain text.

Example response

{
  "message": "Domain successfully unlinked"
}

Changes

Changed in 2 of the 12 revisions of this API.2