Remove Custom Domain from Status Page

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

Remove Custom Domain from Status Page

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

Removes a custom domain from a status page. Deletes the domain record; the status page's customDomainId is automatically set to null. Admin-only.

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 not an admin
  • 404 Not found when the domain does not exist
  • 422 Unprocessable Entity when the domain ID is invalid