Kunden löschen

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 nur Organisations-Admins. Editoren, Nur-Lesen-Nutzer und kundengebundene API-Tokens erhalten 403.

Nutzer des KundenAnkerlink kopieren

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:

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.

AuthentifizierungAnkerlink kopieren

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

Beispiel-AnfrageAnkerlink kopieren

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

Beispiel-AntwortAnkerlink kopieren

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

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

Häufige FehlerAnkerlink kopieren

• 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 kein Organisations-Admin ist oder ein kundengebundenes Token nutzt
• 404 Not Found mit data.code: "customerNotFound", wenn der Kunde in deiner Organisation nicht existiert