Delete a domain

DELETE /v1/domains/{id}

Stops traffic at our edge immediately. The customer's CNAME keeps pointing at us until they remove it on their side, but that's harmless — once a hostname has no domain row, our edge returns 404.

The domain count is decremented on the Stripe subscription in the same operation, so removing domains mid-cycle is prorated automatically.

Request

curl -X DELETE https://api.domainee.dev/v1/domains/$DOMAIN_ID \
  -H "Authorization: Bearer $DOMAINEE_API_KEY"

Response — 204 No Content

Empty body. The domain.deleted webhook fires for every subscribed endpoint.

Errors

Status	Code	When
404	not_found	The id doesn't exist or doesn't belong to your workspace