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
| Parameter | Type | Description |
|---|---|---|
id | number | The 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 Unauthorizedwhen not authenticated403 Forbiddenwhen you are an organization-wide caller without the role admin or editor403 Forbidden(managed_by_organization) when you are customer-bound (user, also with the rolereadonly, or token) and the page ismanagedwithout the customer'scanEditManagedexception404 Not foundwhen the domain does not exist422 Unprocessable Entitywhen the domain ID is invalid
Subscribe to a Status Page
Public endpoint behind the subscribe form: email, SMS, browser push, webhook, Slack or Microsoft Teams, for the whole page or selected components. Double opt-in for every channel.
Update Status Page
Updates a status page. At least one field must be provided. Requires the role `admin` or `editor`; customer-bound users and tokens (also `readonly`) update self-service pages of their customers.