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