Link custom domain

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

Attaches the domain to Base44's hosting and starts DNS verification.

Call this after adding a domain. It's also how you put a domain back into service after Unlink custom domain. Linking re-enables any email domain configured on it.

The response body is null, so read the domain back with Get custom domain. Verification doesn't finish here. Linking only asks the provider to start checking DNS, so poll Get custom domain status until verificationStatus is verified.

DNS propagation happens outside Base44, so a linked domain can sit unverified for as long as its nameservers take.

post/api/apps/{app_id}/custom-domains/{domain_id}/link

Path parameters

app_idstring required

ID of the app the domain belongs to.

domain_idstring required

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

Response

The domain is attached and verification has started. The body is null.

{"stackTrail":"paths:/api/apps/{app_id}/custom-domains/{domain_id}/link:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 1 revision of this API.