diff --git a/api-ref/source/v2/volumes-v2-volumes.inc b/api-ref/source/v2/volumes-v2-volumes.inc
index aa78b437a63..26a48bbd7a3 100644
--- a/api-ref/source/v2/volumes-v2-volumes.inc
+++ b/api-ref/source/v2/volumes-v2-volumes.inc
@@ -460,7 +460,7 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
-   - metadata: metadata
+   - metadata: metadata_3
    - tenant_id: tenant_id
    - volume_id: volume_id
 
@@ -477,9 +477,14 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
-   - metadata: metadata
+   - metadata: metadata_3
 
 
+Response Example
+----------------
+
+.. literalinclude:: ./samples/volume-metadata-create-response.json
+   :language: javascript
 
 
 
@@ -509,7 +514,7 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
-   - metadata: metadata
+   - metadata: metadata_3
 
 
 
@@ -542,7 +547,7 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
-   - metadata: metadata
+   - metadata: metadata_3
    - tenant_id: tenant_id
    - volume_id: volume_id
 
@@ -559,7 +564,7 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
-   - metadata: metadata
+   - metadata: metadata_3
 
 
 
diff --git a/api-ref/source/v3/volumes-v3-volumes.inc b/api-ref/source/v3/volumes-v3-volumes.inc
index 65a49bf5fe3..3782efa9743 100644
--- a/api-ref/source/v3/volumes-v3-volumes.inc
+++ b/api-ref/source/v3/volumes-v3-volumes.inc
@@ -460,7 +460,7 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
-   - metadata: metadata
+   - metadata: metadata_3
    - project_id: project_id_path
    - volume_id: volume_id
 
@@ -477,9 +477,15 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
-   - metadata: metadata
+   - metadata: metadata_3
 
 
+Response Example
+----------------
+
+.. literalinclude:: ./samples/volume-metadata-create-response.json
+   :language: javascript
+
 
 
 
@@ -509,7 +515,7 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
-   - metadata: metadata
+   - metadata: metadata_3
 
 
 
@@ -542,7 +548,7 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
-   - metadata: metadata
+   - metadata: metadata_3
    - project_id: project_id_path
    - volume_id: volume_id
 
@@ -559,7 +565,7 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
-   - metadata: metadata
+   - metadata: metadata_3