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:
userAction | Wirkung |
|---|---|
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. |
delete | Die 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 Requestmitdata.code: "invalidUserAction", wennuserActionwederdeactivatenochdeleteist. Es wird nichts gelöscht.403 Forbiddenmitdata.code: "forbidden", wenn der Aufrufer weder Organisations-Admin noch Editor ist (Nur-Lesen, Global Supporter, Responder) oder ein kundengebundenes Token nutzt403 Forbiddenmitdata.code: "customerUserDeleteAdminOnly", wenn ein EditoruserAction=deletesendet. Es wird nichts gelöscht.409 Conflictmitdata.code: "cannotDeleteOwnLastCustomer", wenn ein Editor mit Kundenzuordnung damit seinen letzten Kunden löschen würde. Es wird nichts gelöscht.404 Not Foundmitdata.code: "customerNotFound", wenn der Kunde in deiner Organisation nicht existiert