
# Management-Client löschen

`DELETE /v1/management-clients/{application_id}` · Berechtigung `management-clients:write`

Löscht den Management-Client-Datensatz einer Anwendung. Die Anwendung und ihre Berechtigungsnachweise bleiben erhalten. Das Löschen der Anwendung selbst (`DELETE /v1/applications/{application_id}`) entfernt auch diesen Datensatz; danach antworten dieser Endpunkt und `GET` mit `404`. `If-Match` ist erforderlich: Ohne es schlägt die Anfrage mit `428` fehl, mit einer nicht mehr passenden Version mit `412`. Nur ein API-Schlüssel kann diesen Endpunkt aufrufen.

## Anfrage

| Parameter | In | Beschreibung |
|---|---|---|
| `application_id` | Pfad | Anwendungs-ID (`app_…`). |
| `If-Match` | Header | Das `ETag` aus dem letzten Lesen oder Schreiben. |

## Antwort

`204 No Content`

## Fehler

| HTTP | code | Wann |
|---|---|---|
| 403 | `insufficient_permissions` | Der Berechtigungsnachweis hat nicht `management-clients:write`, oder es ist kein API-Schlüssel. |
| 403 | `permission_escalation` | Der Datensatz ist umfassender als der aufrufende Schlüssel. |
| 404 | `not_found` | Die Anwendung hat in dieser Umgebung keinen Datensatz. |
| 412 | `precondition_failed` | `If-Match` stimmt nicht mit der aktuellen Version überein. |
| 428 | `precondition_required` | `If-Match` fehlt. |

## Beispiel

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/management-clients/app_01h455vb4pex5vsknk084sn02q \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "3f2a9c0d7b1e4a6f8c5d2e1b0a9f8e7d"'
```

CLI: `keenauth management-clients delete app_01h455vb4pex5vsknk084sn02q --if-match '"3f2a9c0d7b1e4a6f8c5d2e1b0a9f8e7d"' --yes`
