Skip to Content
Uptimeify Docs

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

ParameterTypBeschreibung
idnumberDie 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 authentifiziert
  • 403 Forbidden, wenn du organisationsweit ohne die Rolle Admin oder Editor aufrufst
  • 403 Forbidden (managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rolle readonly, oder Token) und die Seite managed ist, ohne die Ausnahme canEditManaged des Kunden
  • 404 Not found, wenn die Domain nicht existiert
  • 422 Unprocessable Entity, wenn die Domain-ID ungültig ist

Auf dieser Seite