Skip to content

Add operationId to Admin REST API for OpenAPI spec generation#39011

Open
klahap wants to merge 1 commit intokeycloak:mainfrom
goquati:main
Open

Add operationId to Admin REST API for OpenAPI spec generation#39011
klahap wants to merge 1 commit intokeycloak:mainfrom
goquati:main

Conversation

@klahap
Copy link

@klahap klahap commented Apr 16, 2025

This PR adds operationId values to the Keycloak Admin REST API endpoints.
These operationIds are included in the generated OpenAPI spec, which makes it easier for client generator tools (like OpenAPI Generator or Swagger Codegen) to produce readable and consistent method names.

Motivation

  • Improves developer experience when generating API clients from the OpenAPI spec.
  • Allows for better naming consistency and predictability in generated code.
  • Enables easier maintenance of custom clients or tooling relying on the OpenAPI spec.

Let me know if you’d like the naming scheme to follow a different convention, or if you'd prefer to limit this to a subset of endpoints.

@klahap klahap requested a review from a team as a code owner April 16, 2025 07:17
Signed-off-by: Klaus Happacher <k.happacher@gmail.com>
@KimToehler
Copy link

Great work. I've been waiting for something like this for a long time 👍

@ArieGato
Copy link

Is there any status concerning this PR. I would very much like to use it.

@ryumartinez
Copy link

Please approve this PR 🙏🙏

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants