---
title: "Kunden löschen"
description: "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 nur Organisations-Admins. Editoren, Nur-Lesen-Nutzer und kundengebundene
API-Tokens erhalten `403`.

## 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](/de/api/users/update-user) 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

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

## Beispiel-Anfrage

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

## Beispiel-Antwort

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