Eliminar un cliente de gestión
DELETE /v1/management-clients/{application_id} · permiso management-clients:write
Elimina el registro de cliente de gestión de una aplicación. La aplicación y sus credenciales se conservan. Eliminar la propia aplicación (DELETE /v1/applications/{application_id}) también elimina este registro; después, este endpoint y GET responden 404. If-Match es obligatorio: sin él, la solicitud falla con 428, y con una versión que ya no coincide falla con 412. Solo una clave de API puede llamar a este endpoint.
Solicitud
| Parámetro | En | Descripción |
|---|---|---|
application_id |
ruta | ID de la aplicación (app_…). |
If-Match |
cabecera | El ETag de la última lectura o escritura. |
Respuesta
204 No Content
Errores
| HTTP | code | Cuándo |
|---|---|---|
| 403 | insufficient_permissions |
La credencial no tiene management-clients:write, o no es una clave de API. |
| 403 | permission_escalation |
El registro es más amplio que la clave que realiza la llamada. |
| 404 | not_found |
La aplicación no tiene registro en este entorno. |
| 412 | precondition_failed |
If-Match no coincide con la versión actual. |
| 428 | precondition_required |
Falta If-Match. |
Ejemplo
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