
# Kontosperre aufheben

`DELETE /v1/attack-protection/lockouts/{lockout_id}` · Berechtigung `attack-protection:write`

Hebt eine offene Kontosperre auf: Der Benutzer kann sich auf diesem Weg wieder anmelden, und der Fehlerzähler für diesen Weg beginnt von vorn. Das Ereignis `user.unlocked` (`by = admin`) und ein Verwaltungs-Audit-Datensatz (`user.unlocked`, Ziel der Benutzer) werden in derselben Transaktion geschrieben, mit Ihren Zugangsdaten als Akteur. Um alle Sperren eines Benutzers auf einmal aufzuheben, verwenden Sie [`POST /v1/users/{user_id}:unlock`](../users/unlock.md).

## Anfrage

| Parameter | In | Erforderlich | Beschreibung |
|---|---|---|---|
| `lockout_id` | path | ja | Sperr-ID mit Präfix `lck_`. |

## Antwort

`204 No Content`, ohne Body.

## Fehler

Jeder Fehler ist ein `application/problem+json`-Body mit einem stabilen `code`.

| HTTP | `code` | Wann |
|---|---|---|
| 404 | `not_found` | Keine offene Sperre hat diese ID in dieser Umgebung: Sie hat nie existiert, wurde bereits aufgehoben oder ist abgelaufen (oder die ID ist fehlerhaft). |
| 401 | `unauthenticated` | Der API-Schlüssel fehlt, ist ungültig oder widerrufen. |
| 403 | `insufficient_permissions` | Dem Schlüssel fehlt die Berechtigung `attack-protection:write`. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; beachten Sie `Retry-After`. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; später erneut versuchen. |

## Beispiel

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/attack-protection/lockouts/lck_01jaz8m5c3f6t9w2y4b7d0g3k6 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

CLI: `keenauth attack-protection lockouts delete lck_01jaz8m5c3f6t9w2y4b7d0g3k6`
