
# Rimuovi un blocco dell'account

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

Rimuove un blocco di account attivo: l'utente può di nuovo accedere su quel percorso e il conteggio dei tentativi falliti per il percorso riparte da zero. L'evento `user.unlocked` (`by = admin`) e un record di audit di gestione (`user.unlocked`, con l'utente come destinatario) vengono scritti nella stessa transazione, con la credenziale utilizzata come attore. Per rimuovere in una sola volta tutti i blocchi di un utente, usare [`POST /v1/users/{user_id}:unlock`](../users/unlock.md).

## Richiesta

| Parametro | In | Obbligatorio | Descrizione |
|---|---|---|---|
| `lockout_id` | path | sì | ID del blocco, con prefisso `lck_`. |

## Risposta

`204 No Content`, senza corpo.

## Errori

Ogni errore è un body `application/problem+json` con un `code` stabile.

| HTTP | `code` | Quando |
|---|---|---|
| 404 | `not_found` | Nell'ambiente non esiste un blocco attivo con questo ID: non è mai esistito, è già stato rimosso, è scaduto, oppure l'ID è malformato. |
| 401 | `unauthenticated` | La chiave API manca, non è valida o è stata revocata. |
| 403 | `insufficient_permissions` | La chiave non ha il permesso `attack-protection:write`. |
| 429 | `rate_limited` | È stato superato il limite di frequenza; attendi il periodo indicato in `Retry-After`. |
| 503 | `service_unavailable` | Una dipendenza non è disponibile temporaneamente; riprova più tardi. |

## Esempio

```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`
