# Forzare una reimpostazione della password

`POST /v1/users/{user_id}:force-password-reset` · permesso `user-credentials:write`

Richiede all'utente di scegliere una nuova password: dopo il suo prossimo accesso riuscito con password non può proseguire finché non imposta una nuova password. L'hash della password attuale non viene eliminato: l'utente accede ancora una volta con esso e poi ne imposta uno nuovo. Richiamare l'operazione più volte è sicuro: se l'utente è già contrassegnato, viene mantenuta l'ora del primo contrassegno. L'azione viene scritta nel log di audit di gestione (`user.password_reset_forced`) e genera l'evento `password_reset.scheduled`. Per contrassegnare più utenti contemporaneamente, usare [Creare un job di reimpostazione della password in blocco](/docs/api/management/jobs/create-password-reset).

La richiesta non ha un corpo (non inviarne uno, oppure `{}`). Inviare un'intestazione `Idempotency-Key` per rendere sicuri i nuovi tentativi.

## Richiesta

| Parametro | In | Obbligatorio | Descrizione |
|---|---|---|---|
| `user_id` | percorso | sì | ID utente, con prefisso `usr_`. |

## Risposta

`204 No Content`.

## Errori

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

| HTTP | `code` | Quando |
|---|---|---|
| 400 | `malformed_request`, `unknown_field` | Il corpo non è JSON valido oppure ha un campo sconosciuto. |
| 401 | `unauthenticated` | La chiave API è mancante, non valida o revocata. |
| 403 | `insufficient_permissions` | La chiave non ha il permesso `user-credentials:write`. |
| 404 | `not_found` | L'utente non esiste in questo ambiente (oppure l'ID non è valido). |
| 409 | `conflict` | L'utente non ha una password. |
| 429 | `rate_limited` | È stato superato il limite di frequenza; rispettare `Retry-After`. |
| 503 | `service_unavailable` | Una dipendenza non è temporaneamente disponibile; riprovare più tardi. |

## Esempio

```bash
curl -X POST https://api.eu.keenauth.com/v1/users/usr_01h455vb4pex5vsknk084sn02q:force-password-reset \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

CLI: `keenauth users force-password-reset usr_01h455vb4pex5vsknk084sn02q`