Skip to content

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.

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:

Remove a project domain
comwit domains delete --project <projectId> --domain example.com

The equivalent API route:

API
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.

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.

Purchase API routes
GET /v1/domains/availability?domain=example.com
GET /v1/domains/suggestions?domain=example.com&count=10
GET /v1/domains/prices?tld=com
POST /v1/projects/{projectId}/domain-orders
GET /v1/projects/{projectId}/domain-orders/{orderId}
PUT /v1/projects/{projectId}/domain-orders/{orderId}/registration
GET /v1/projects/{projectId}/domain-orders/{orderId}/registration

Create 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.

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}/renewal
PUT /v1/projects/{projectId}/domains/{domain}/auto-renew

GET 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.