Domain statuses
The domain lifecycle uses these states:
| Status | Badge | Meaning |
|---|
| Pending | Amber | Domain is registered but DNS is not yet verified |
| Active | Green | DNS is verified, SSL is provisioned, domain is serving traffic |
| Removing | Amber | Domain is being de-provisioned (transient, during cleanup) |
pending to active. When a domain is removed, it briefly shows removing before it disappears from the page.
Remove a custom domain
To remove a custom domain:
Open Domains
Navigate to Domains in the sidebar.
Open the row menu
Click the actions menu on the custom domain row and select Remove.
Confirm deletion
A confirmation dialog appears:
Remove custom domain?
will be removed. API requests will stop working immediately.
Click Remove to confirm. | What happens | Detail |
|---|
| API traffic stops immediately | Requests to the custom domain return errors |
Domain is marked removing | The row reflects cleanup in progress before deletion |
| Domain connection is removed | Routing through the custom domain stops |
| Domain disappears from the page | You can add a new custom domain again if eligible |
| Default endpoint is unaffected | Your default API endpoint continues to work |
Removal is permanent. API requests to the custom domain stop working immediately. Make sure all your integrations have been updated to use the default endpoint or a new custom domain before removing.
What happens on plan changes
Custom domains are an Enterprise plan feature. If your subscription changes, your domain may be affected:
Downgrade from Enterprise
If you downgrade from Enterprise to a lower plan (Starter, Pro, or Scale):
| Step | What happens |
|---|
| Domain marked as removing | The domain enters the removing status |
| Domain connection removed | The custom domain stops serving API traffic |
| Domain removed | The domain is permanently removed from your account |
| Activity logged | The removal is recorded in your account’s activity log |
Subscription canceled or deleted
If your Enterprise subscription becomes terminal, custom domains are cleaned up automatically using the same process as a downgrade.
Grace-period subscription states do not remove domains immediately.
Upgrade to Enterprise
After upgrading to Enterprise, you can add a custom domain immediately from the dashboard.
Re-adding a domain
After removing a custom domain (manually or through a plan change), you can add a new one at any time as long as your account has an active Enterprise plan. The new domain goes through the full setup and verification process. You may reuse the same domain name or choose a different one.
Default endpoint
The default API endpoint is always available regardless of plan tier or custom domain status.
In the default docs region, that default API URL is:
https://api.us.babysea.ai/v1
Permissions
| Action | Primary Owner | Owner | Member |
|---|
| View domains | Yes | Yes | Yes |
| Add custom domain | Yes | Yes | No |
| Remove custom domain | Yes | Yes | No |
| Verify domain | Yes | Yes | No |
