Uptimeify Docs

Kunden-Domain löschen

Löscht eine Kunden-Domain.

DELETE /api/customer-domains/:customerDomainPublicId

Hinweise:

  • Readonly-User und Global-Supporter können Kunden-Domains nicht löschen.

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X DELETE "$BASE_URL/api/customer-domains/22222222-2222-4222-8222-222222222222" \
  -H "Authorization: Bearer $TOKEN"

Beispiel-Antwort

{ "success": true }

Häufige Fehler

  • 400 Invalid Domain identifier wenn :customerDomainPublicId weder UUID noch Legacy-ID ist
  • 401 Unauthorized wenn du nicht angemeldet bist
  • 403 Forbidden für Readonly/Global-Supporter-User, oder wenn du keinen Zugriff auf die Domain/den Kunden hast
  • 404 Domain not found wenn die Domain nicht existiert

Berechtigungen

Für die Rolle readonly gesperrt. Ein Nur-Lese-Zugang löscht keine Domain, gleich welcher Besitzklasse, und ein von ihm ausgestellter API-Token ebenso wenig: Ein Token erbt die Rolle seines Erstellers. Das Bearbeiten einer Domain mit self_service bleibt dieser Rolle erlaubt.

Kunden-gescopte Aufrufer bindet zusätzlich die Besitzklasse: Eine managed-Domain wird mit managed_by_organization abgelehnt, solange der Kunde kein canEditManaged trägt.

Auf dieser Seite