Skip to Content
Uptimeify Docs
Status pages

Remove Custom Domain from Status Page

Removes a custom domain from a status page. Deletes the domain record; the status page's customDomainId is automatically set to null. Organization-wide: admin or editor; customer-bound: by the page's ownership class.

DELETE /api/status-pages/domains/:id

Access: Organization-wide callers need the role admin or editor (organization-wide readonly stays read-only). Customer-bound users (also with the role readonly) and customer-bound API tokens follow the page's ownership class instead: allowed on self_service pages, on managed pages only with the customer's canEditManaged exception, otherwise 403 with data.code: managed_by_organization.

Path Parameters

ParameterTypeDescription
idnumberThe domain ID to remove

Example (cURL)

curl -X DELETE "$BASE_URL/api/status-pages/domains/42" \
  -H "Authorization: Bearer $TOKEN"

Response

204 No Content

Common errors

  • 401 Unauthorized when not authenticated
  • 403 Forbidden when you are an organization-wide caller without the role admin or editor
  • 403 Forbidden (managed_by_organization) when you are customer-bound (user, also with the role readonly, or token) and the page is managed without the customer's canEditManaged exception
  • 404 Not found when the domain does not exist
  • 422 Unprocessable Entity when the domain ID is invalid

On this page