Skip to Content
Uptimeify Docs

Kunden löschen

Löscht einen Kunden endgültig und deaktiviert oder löscht die Nutzer, die nur ihm zugeordnet sind.

DELETE /api/customers/:customerPublicId

Löscht einen Kunden endgültig. Seine Monitore, die Check-Historie, Vorfälle, Reports und Screenshots werden mitgelöscht. Das lässt sich nicht rückgängig machen.

Kunden löschen dürfen Organisations-Admins, Editoren und Global Admins. Nur-Lesen-Nutzer, Global Supporter, Responder und kundengebundene API-Tokens erhalten 403. Ein Editor, der bestimmten Kunden zugeordnet ist, löscht nur diese Kunden (jede andere ID antwortet mit 404); ein Editor ohne Kundenzuordnung löscht alle Kunden der Organisation.

Zwei Dinge bleiben beim Admin. Nur ein Admin darf userAction=delete senden; ein Editor erhält 403 mit customerUserDeleteAdminOnly und nutzt die Voreinstellung deactivate. Ein Editor mit Kundenzuordnung kann seinen letzten Kunden nicht löschen: er stünde danach ohne Kunden da und würde sein eigenes Konto deaktivieren, deshalb antwortet die Anfrage mit 409 und cannotDeleteOwnLastCustomer. Beide Prüfungen laufen, bevor etwas gelöscht wird.

Nutzer des Kunden

Nutzer, die nur diesem Kunden zugeordnet sind, können ihr Konto ohne Kunden nicht behalten. Mit ihnen passiert immer eines von beiden, gewählt über den Query-Parameter userAction:

userActionWirkung
deactivate (Standard)Die Nutzer werden deaktiviert. Sie können Dashboard und API nicht mehr nutzen und lassen sich später mit Benutzer aktualisieren wieder aktivieren.
deleteDie Nutzer werden endgültig gelöscht.

Nutzer, die zusätzlich anderen Kunden zugeordnet sind, behalten ihr Konto und verlieren nur den Zugriff auf den gelöschten Kunden. Nutzer ohne Kunden zu behalten, ist nicht vorgesehen.

Authentifizierung

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

Beispiel-Anfrage

curl -X DELETE "$BASE_URL/api/customers/6bfec6f6-245a-47ce-843b-157d97d56f88?userAction=delete" \
  -H "Authorization: Bearer $TOKEN"

Beispiel-Antwort

{
  "success": true,
  "message": "Customer deleted successfully",
  "userAction": "delete",
  "affectedUsers": 1
}

affectedUsers ist die Zahl der Nutzer, die deaktiviert oder gelöscht wurden.

Häufige Fehler

  • 400 Bad Request mit data.code: "invalidUserAction", wenn userAction weder deactivate noch delete ist. Es wird nichts gelöscht.
  • 403 Forbidden mit data.code: "forbidden", wenn der Aufrufer weder Organisations-Admin noch Editor ist (Nur-Lesen, Global Supporter, Responder) oder ein kundengebundenes Token nutzt
  • 403 Forbidden mit data.code: "customerUserDeleteAdminOnly", wenn ein Editor userAction=delete sendet. Es wird nichts gelöscht.
  • 409 Conflict mit data.code: "cannotDeleteOwnLastCustomer", wenn ein Editor mit Kundenzuordnung damit seinen letzten Kunden löschen würde. Es wird nichts gelöscht.
  • 404 Not Found mit data.code: "customerNotFound", wenn der Kunde in deiner Organisation nicht existiert

Auf dieser Seite