# Lösche eine Verbindung

`DELETE /v1/connections/{connection_id}` · Berechtigung `connections:write`

Löscht eine Verbindung. Benutzerdaten werden nicht gelöscht. `If-Match` ist erforderlich. Wenn Benutzer Identitäten von einer aktiven Verbindung haben, schlägt das Löschen mit `connection_in_use` fehl; Deaktiviere die Verbindung zuerst. Die Verbindung wird auch aus Anwendungsverbindungslisten entfernt. Eine gelöschte Verbindung kann innerhalb von 30 Tagen mit [`:restore`](restore.md) als `inactive` wiederhergestellt werden; danach wird sie endgültig gelöscht.

## Anfrage

| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| `connection_id` | string | ja | Verbindungskennung (`conn_…`). |
| `If-Match` | header | ja | Das `ETag` der Verbindung wie zuletzt gelesen. Fehlt: `428`; veraltet: `412`. |

## Antwort

`204 No Content`, kein Body.

## Fehler

| HTTP | Code | Wann |
|---|---|---|
| 404 | `not_found` | Die Verbindung existiert nicht oder gehört einer anderen Umgebung. |
| 409 | `connection_in_use` | Benutzer haben immer noch Identitäten von dieser aktiven Verbindung; Deaktiviere sie zuerst. |
| 412 | `precondition_failed` | `If-Match` stimmt nicht mit der aktuellen Version überein. |
| 428 | `precondition_required` | Der `If-Match`-Header fehlt. |
| 401 | `unauthenticated` | Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen. |
| 403 | `insufficient_permissions` | Die Anmeldedaten haben nicht die erforderliche Berechtigung. |
| 429 | `rate_limited` | Die Rate-Grenze wurde überschritten; Wiederhole nach dem `Retry-After`-Zeitraum. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; Wiederhole nach dem `Retry-After`-Zeitraum. |

## Beispiel

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "2"'
```