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 ; 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
curl -X DELETE https://api.eu.keenauth.com/v1/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H 'If-Match: "2"'