diff --git a/api-ref/source/flavors.inc b/api-ref/source/flavors.inc
index 4d6661f9b..f480778cb 100644
--- a/api-ref/source/flavors.inc
+++ b/api-ref/source/flavors.inc
@@ -32,6 +32,7 @@ Query Parameters
 
   - limit: limit
   - marker: marker
+  - detailed: detailed
 
 Response Parameters
 -------------------
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index d97c724b8..221839c4e 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -68,6 +68,14 @@ claim_limit:
     meaning the server may claim and return less than the requested number of
     messages.
 
+detailed:
+  type: boolean
+  in: query
+  required: false
+  description: |
+    The 'detailed' specifies if showing the detailed information when querying
+    queues, flavors and pools.
+
 echo:
    type: boolean
    in: query
@@ -125,7 +133,6 @@ pop:
 
 #### variables in request ####################################################
 
-
 _default_message_ttl:
   type: integer
   in: body
diff --git a/api-ref/source/pools.inc b/api-ref/source/pools.inc
index 5ecbad489..e24dd9204 100644
--- a/api-ref/source/pools.inc
+++ b/api-ref/source/pools.inc
@@ -33,6 +33,7 @@ Query Parameters
 
   - limit: limit
   - marker: marker
+  - detailed: detailed
 
 Response Parameters
 -------------------
diff --git a/api-ref/source/queues.inc b/api-ref/source/queues.inc
index 151a0385e..a2adb8c9c 100644
--- a/api-ref/source/queues.inc
+++ b/api-ref/source/queues.inc
@@ -39,6 +39,7 @@ Request Parameters
 
   - limit: limit
   - marker: marker
+  - detailed: detailed
 
 Response Parameters
 -------------------