# Supprimer un utilisateur

`DELETE /v1/users/{user_id}` · autorisation `users:delete`

Lance la suppression d'un utilisateur. L'utilisateur passe immédiatement à `pending_deletion` et la suppression est due dès maintenant ; la suppression définitive s'exécute ensuite de manière asynchrone. La réponse est `202 Accepted` avec un `deletion_id`. Répéter la requête pour le même utilisateur renvoie le même `deletion_id`. Ce point de terminaison ne prévoit aucune fenêtre d'annulation.

## Requête

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

## Réponse

`202 Accepted`.

```json
{
  "deletion_id": "0191f0a0-0000-8000-8000-000000000001",
  "requested_at": "2026-01-15T09:30:00Z"
}
```

## Erreurs

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

| HTTP | `code` | Quand |
|---|---|---|
| 404 | `not_found` | L'utilisateur n'existe pas dans cet environnement (ou l'identifiant est mal formé). |
| 401 | `unauthenticated` | La clé API est absente, invalide ou révoquée. |
| 403 | `insufficient_permissions` | La clé ne dispose pas de l'autorisation `users:delete`. |
| 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 DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

## Données personnelles

Ce point de terminaison traite des données personnelles : profil de l'utilisateur final. [Données personnelles dans les API KeenAuth](/docs/policies/personal-data) décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. N'envoyez de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.