Hidden parameter in springdoc-openapi doesn't work

Question

I have Spring Boot application with version 2.3.0. and springdoc-openapi-webflux-ui in version 1.4.1.

I have annotated parameter in operation like this.

parameters = {
@Parameter(
    hidden = true, schema = @Schema(implementation = Boolean.class),
    in = ParameterIn.QUERY, name = DO_NOT_FORWARD
)

With hidden = true I expected that this parameter will not be visible in swagger-ui. But it is. Did I misunderstood this parameter or is it not doing what it was supposed to do?

I want this parameter to be in api-docs, to have generated client able to use this parameter, but I want it invisible in swagger-ui

Can you provide a snippet of the method? The Current piece of code doesn't convey a proper sense of where and how you're using it — Debargha Roy

brianbro brianbro · Accepted Answer · 2020-06-25T11:21:34

You just make sure that the name of in the @Parameter annotation, is the exact name of the operation parameter you want to hide.

You can have a look at the documentation as well:

https://springdoc.org/faq.html#how-can-i-hide-a-parameter-from-the-documentation-

If you are still having coniguration issue, you can add the code of sample HelloController that reproduces your problem, or you can add the link to a minimal, reproducible sample in github.

Hidden parameter in springdoc-openapi doesn't work

1 Answers