Remove, purchase & renew a domain
A project domain is a domain you connected to Comwit Cloud so the platform can manage its DNS. This page covers removing delegated domains, trusted-server domain purchase, and registrar auto-renew settings.
If you are new here, start with Bring your own domain to see how a domain is connected in the first place, and DNS records for managing the records inside it.
Remove a domain
Section titled “Remove a domain”Removing a domain stops Comwit from managing its DNS and tears down the Route 53 hosted zone that was created when you connected it. You can do this from the CLI:
comwit domains delete --project <projectId> --domain example.comThe equivalent API route:
DELETE /v1/projects/{projectId}/domains/{domain}When you remove a domain, Comwit:
- Deletes the active Route 53 records in the zone — including any platform-owned records Comwit wrote for an app hostname (for example, records created by connecting an app to your domain).
- Deletes the Route 53 hosted zone itself.
- Soft-deletes the project-domain row. The domain is not erased: its audit and operation history stays inspectable, and you can re-add the same domain later if you change your mind.
Purchase a domain
Section titled “Purchase a domain”Trusted servers can search, quote, and register through Route 53 Domains. Browser checkout remains an application integration concern. The server must verify payment before submitting registration; Cloud does not verify Comwit’s subscription payments.
GET /v1/domains/availability?domain=example.comGET /v1/domains/suggestions?domain=example.com&count=10GET /v1/domains/prices?tld=comPOST /v1/projects/{projectId}/domain-ordersGET /v1/projects/{projectId}/domain-orders/{orderId}PUT /v1/projects/{projectId}/domain-orders/{orderId}/registrationGET /v1/projects/{projectId}/domain-orders/{orderId}/registrationCreate a durable quote with Idempotency-Key before charging the customer.
Quotes do not reserve or register the domain. Registration requires one year,
privacy enabled, the exact quoted domain and total, and a legal registrant
contact. auto_renew defaults to false and can be true. The charging PUT
requires domain:purchase and the server confirmation header; poll registration
GET after submission rather than blindly resubmitting an uncertain purchase.
Success automatically connects a managed route53_registered project domain.
These domains cannot be removed through the normal domain-delete route.
Manage purchased domain renewal
Section titled “Manage purchased domain renewal”These routes support domains registered through Comwit
(dns_mode=route53_registered) after registration and hosted zone binding are
complete, regardless of DNS delegation state. Both managed and
pending_delegation domains with a hosted zone binding can read or change
renewal settings. Externally registered domains, pending_zone, failed,
deleting, other statuses, and missing hosted zone bindings return 409 without
a registrar call.
GET /v1/projects/{projectId}/domains/{domain}/renewalPUT /v1/projects/{projectId}/domains/{domain}/auto-renewGET requires domain:read and returns the live registrar expiry, auto-renew
setting, status codes, current renewal price, and renewal cutoff. PUT requires
domain:purchase plus the server-only
X-Comwit-Domain-Purchase-Confirmation header, with {"enabled":true} or
{"enabled":false}. Use server credentials and the actor user header; never
expose the confirmation secret in browser code.
When the global purchase switch (PLATFORM_API_DOMAIN_PURCHASE_ENABLED) is off,
new paid registrations and auto-renew enabling return 501 without a provider
call. Renewal reads and disabling remain available with the usual authorization
and finalized-registration requirements. Successful GET and PUT return 200:
{"renewal":{ "domain":"example.com", "provider":"route53domains", "expires_at":"2027-10-21T00:00:00Z", "auto_renew":true, "renewal_window_days":35, "renewal_cutoff_at":"2027-09-16T00:00:00Z", "renewal_price":{"amount":"13.00","currency":"USD"}, "registrar_status":["clientTransferProhibited"]}}PUT is synchronous and idempotent, and reads the setting back from Route 53 before returning. There is no operation id or idempotency key. Disabling changes only the renewal flag: it does not shorten the registration period, delete the hosted zone or records, or disconnect the project domain. Registered domains remain protected from the normal domain-delete route.
auto_renew in a purchase quote defaults to false; set it to true to register
with automatic renewal enabled. Enabling authorizes future AWS renewal charges.
Comwit manages the customer’s subscription and must finish payment/cancellation
and disable renewal before renewal_cutoff_at if renewal must not occur.
Executed renewals cannot be cancelled. The cutoff is expiry minus 35 days;
.com.ar and .com.br are the only exceptions, at 30 days, according to
AWS domain renewal
(verified 2026-10-21). AWS generally renews for one year; some TLDs have longer
terms. A late enable may trigger renewal within 24 hours. Expiry and cutoff
are omitted when expiry is unavailable; the renewal price is current registrar
pricing, not a locked quote or the subscription price.