Delete Customer Domain

DELETE /api/customer-domains/:customerDomainPublicId

Notes:

• Readonly users and global supporters cannot delete customer domains.

Example (cURL)Copy Anchor Link

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X DELETE "$BASE_URL/api/customer-domains/22222222-2222-4222-8222-222222222222" \
  -H "Authorization: Bearer $TOKEN"

Example ResponseCopy Anchor Link

{ "success": true }

Common errorsCopy Anchor Link

• 400 Invalid Domain identifier when :customerDomainPublicId is neither a valid UUID nor a legacy numeric ID
• 401 Unauthorized when you are not logged in
• 403 Forbidden for readonly/global supporter users, or when you cannot access the domain/customer
• 404 Domain not found when the domain does not exist

PermissionsCopy Anchor Link

Closed to the readonly role. A read-only login deletes no domain, whatever its ownership class, and neither does an API token it issued: a token inherits the role of the user who created it. Editing a self_service domain stays open to that role.

A customer-scoped caller is bound by ownership class on top of that: a managed domain is refused with managed_by_organization unless its customer carries canEditManaged.