diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index 83982c8c239..687323bfb44 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -2261,6 +2261,30 @@ provider_optional:
   in: body
   required: false
   type: string
+qos_association_id:
+  description: |
+    The Qos association ID.
+  in: body
+  required: true
+  type: string
+qos_association_name:
+  description: |
+    The QoS association name.
+  in: body
+  required: true
+  type: string
+qos_association_type:
+  description: |
+    The QoS association type.
+  in: body
+  required: true
+  type: string
+qos_associations:
+  description: |
+    A collection of ``QoS associations``.
+  in: body
+  required: true
+  type: array
 qos_set_id:
   description: |
     The QoS set ID.
diff --git a/api-ref/source/v3/qos-specs-v3-qos-specs.inc b/api-ref/source/v3/qos-specs-v3-qos-specs.inc
index 879a5710372..00ffdcf6af4 100644
--- a/api-ref/source/v3/qos-specs-v3-qos-specs.inc
+++ b/api-ref/source/v3/qos-specs-v3-qos-specs.inc
@@ -95,18 +95,16 @@ Response
 
 .. rest_parameters:: parameters.yaml
 
-   - qos_specs: qos_specs
-   - specs: specs
-   - consumer: consumer_1
-   - name: name_4
-   - id: id_3
-   - links: links_2
+   - qos_associations: qos_associations
+   - type: qos_association_type
+   - id: qos_association_id
+   - name: qos_association_name
 
 
 Response Example
 ----------------
 
-.. literalinclude:: ./samples/qos-show-response.json
+.. literalinclude:: ./samples/qos_show_response.json
    :language: javascript
 
 
@@ -333,6 +331,13 @@ Response Parameters
    - specs: specs
 
 
+Response Example
+----------------
+
+.. literalinclude:: ./samples/qos-create-response.json
+   :language: javascript
+
+
 List QoS Specifications
 ~~~~~~~~~~~~~~~~~~~~~~~