diff --git a/docs/src/main/asciidoc/resteasy-reactive.adoc b/docs/src/main/asciidoc/resteasy-reactive.adoc
index f75a07c6e412d..763957627a3e8 100644
--- a/docs/src/main/asciidoc/resteasy-reactive.adoc
+++ b/docs/src/main/asciidoc/resteasy-reactive.adoc
@@ -383,13 +383,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