# Supprimer une connexion

`DELETE /v1/connections/{connection_id}` · permission `connections:write`

Supprime une connexion. Les données de l'utilisateur ne sont pas supprimées. `If-Match` est obligatoire. Si les utilisateurs ont des identités d'une connexion active, la suppression échoue avec `connection_in_use` ; désactivez d'abord la connexion. La connexion est également supprimée des listes de connexions d'application. Une connexion supprimée peut être restaurée à l'état `inactive` pendant 30 jours avec [`:restore`](restore.md) ; ensuite elle est supprimée définitivement.

## Requête

| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| `connection_id` | string | oui | Identifiant de la connexion (`conn_…`). |
| `If-Match` | header | oui | L'`ETag` de la connexion telle qu'elle a été lue en dernier. Manquant : `428` ; obsolète : `412`. |

## Réponse

`204 No Content`, pas de corps.

## Erreurs

| HTTP | code | Quand |
|---|---|---|
| 404 | `not_found` | La connexion n'existe pas ou appartient à un autre environnement. |
| 409 | `connection_in_use` | Les utilisateurs ont toujours des identités de cette connexion active ; désactivez-la d'abord. |
| 412 | `precondition_failed` | `If-Match` ne correspond pas à la version actuelle. |
| 428 | `precondition_required` | L'en-tête `If-Match` est manquant. |
| 401 | `unauthenticated` | L'authentification est manquante, invalide ou révoquée. |
| 403 | `insufficient_permissions` | L'authentification manque la permission requise. |
| 429 | `rate_limited` | La limite de débit a été dépassée ; réessayez après la période `Retry-After`. |
| 503 | `service_unavailable` | Une dépendance est temporairement indisponible ; réessayez après la période `Retry-After`. |

## Exemple

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "2"'
```