diff --git a/docs/src/main/asciidoc/resteasy-reactive.adoc b/docs/src/main/asciidoc/resteasy-reactive.adoc
index 97549a0a2fc4d..37681074dc5a7 100644
--- a/docs/src/main/asciidoc/resteasy-reactive.adoc
+++ b/docs/src/main/asciidoc/resteasy-reactive.adoc
@@ -382,13 +382,14 @@ public class Endpoint {
     }
 
     @POST
-    public String allParams(Parameters parameters) {
+    public String allParams(@BeanParam Parameters parameters) { <1>
         return parameters.type + "/" + parameters.variant + "/" + parameters.age 
             + "/" + parameters.level + "/" + parameters.secretHandshake
             + "/" + parameters.smell;
     }
 }
 ----
+<1>  `BeanParam` is required to comply with the JAX-RS specification so that libraries like OpenAPI can introspect the parameters.
 
 === Declaring URI parameters