# Forcer une réinitialisation du mot de passe

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

Oblige l'utilisateur à choisir un nouveau mot de passe : après sa prochaine connexion réussie par mot de passe, il ne peut pas continuer tant qu'il n'a pas défini un nouveau mot de passe. Le hachage de mot de passe actuel n'est pas supprimé : l'utilisateur se connecte une fois de plus avec celui-ci, puis en définit un nouveau. Rappeler l'opération est sans risque : si l'utilisateur est déjà signalé, la date du premier signalement est conservée. L'action est inscrite dans le journal d'audit de gestion (`user.password_reset_forced`) et émet l'événement `password_reset.scheduled`. Pour signaler plusieurs utilisateurs à la fois, utilisez [Créer une tâche de réinitialisation du mot de passe en masse](/docs/api/management/jobs/create-password-reset).

La requête n'a pas de corps (n'en envoyez aucun, ou `{}`). Envoyez un en-tête `Idempotency-Key` pour rendre les nouvelles tentatives sûres.

## Demande

| Paramètre | Dans | Requis | Description |
|---|---|---|---|
| `user_id` | path | oui | Identifiant de l'utilisateur, préfixé `usr_`. |

## Réponse

`204 No Content`.

## Erreurs

Chaque erreur est un corps `application/problem+json` avec un `code` stable.

| HTTP | `code` | Quand |
|---|---|---|
| 400 | `malformed_request`, `unknown_field` | Le corps n'est pas du JSON valide ou contient un champ inconnu. |
| 401 | `unauthenticated` | La clé d'API est absente, invalide ou révoquée. |
| 403 | `insufficient_permissions` | La clé ne possède pas l'autorisation `user-credentials:write`. |
| 404 | `not_found` | L'utilisateur n'existe pas dans cet environnement (ou l'identifiant est mal formé). |
| 409 | `conflict` | L'utilisateur n'a pas de mot de passe. |
| 429 | `rate_limited` | La limite de débit a été dépassée ; respectez `Retry-After`. |
| 503 | `service_unavailable` | Une dépendance est temporairement indisponible ; réessayez plus tard. |

## Exemple

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