Eigene Domain entfernen
Entfernt eine eigene Domain von einer Statusseite. Löscht den Domain-Datensatz; die customDomainId der Statusseite wird automatisch auf null gesetzt. Org-weit Admin oder Editor, kundengebunden nach der Eigentumsklasse der Seite.
DELETE /api/status-pages/domains/:id
Zugriff: Organisationsweite Aufrufer brauchen die Rolle admin oder editor (organisationsweites readonly bleibt lesend). Kundengebundene Nutzer (auch mit der Rolle readonly) und kundengebundene API-Tokens folgen stattdessen der Eigentumsklasse der Seite: erlaubt auf self_service-Seiten, auf managed-Seiten nur mit der Ausnahme canEditManaged des Kunden, sonst 403 mit data.code: managed_by_organization.
Pfad-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
id | number | Die zu entfernende Domain-ID |
Beispiel (cURL)
curl -X DELETE "$BASE_URL/api/status-pages/domains/42" \
-H "Authorization: Bearer $TOKEN"Antwort
204 No Content
Häufige Fehler
401 Unauthorized, wenn nicht authentifiziert403 Forbidden, wenn du organisationsweit ohne die Rolle Admin oder Editor aufrufst403 Forbidden(managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rollereadonly, oder Token) und die Seitemanagedist, ohne die AusnahmecanEditManageddes Kunden404 Not found, wenn die Domain nicht existiert422 Unprocessable Entity, wenn die Domain-ID ungültig ist