Supprimer un client de gestion
DELETE /v1/management-clients/{application_id} · autorisation management-clients:write
Supprime l'enregistrement de client de gestion d'une application. L'application et ses identifiants sont conservés. La suppression de l'application elle-même (DELETE /v1/applications/{application_id}) supprime aussi cet enregistrement ; ensuite, ce point de terminaison et GET répondent 404. If-Match est obligatoire : sans lui, la requête échoue avec 428 ; avec une version qui ne correspond plus, elle échoue avec 412. Seule une clé d'API peut appeler ce point de terminaison.
Requête
| Paramètre | Emplacement | Description |
|---|---|---|
application_id |
chemin | Identifiant de l'application (app_…). |
If-Match |
en-tête | Le ETag de la dernière lecture ou écriture. |
Réponse
204 No Content
Erreurs
| HTTP | code | Quand |
|---|---|---|
| 403 | insufficient_permissions |
L'identifiant ne possède pas management-clients:write, ou ce n'est pas une clé d'API. |
| 403 | permission_escalation |
L'enregistrement est plus large que la clé appelante. |
| 404 | not_found |
L'application n'a pas d'enregistrement dans cet environnement. |
| 412 | precondition_failed |
If-Match ne correspond pas à la version actuelle. |
| 428 | precondition_required |
If-Match est absent. |
Exemple
curl -X DELETE https://api.eu.keenauth.com/v1/management-clients/app_01h455vb4pex5vsknk084sn02q \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H 'If-Match: "3f2a9c0d7b1e4a6f8c5d2e1b0a9f8e7d"'
CLI : keenauth management-clients delete app_01h455vb4pex5vsknk084sn02q --if-match '"3f2a9c0d7b1e4a6f8c5d2e1b0a9f8e7d"' --yes