diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index ffbeef02823..69a0039b7d6 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -1122,12 +1122,6 @@ name_7:
   in: body
   required: true
   type: string
-name_8:
-  description: |
-    The volume name.
-  in: body
-  required: false
-  type: string
 name_9:
   description: |
     The consistency group name.
@@ -1743,6 +1737,12 @@ volume_name:
   in: body
   required: true
   type: string
+volume_name_optional:
+  description: |
+    The volume name.
+  in: body
+  required: false
+  type: string
 volume_type_1:
   description: |
     A ``volume_type`` object.
diff --git a/api-ref/source/v2/volumes-v2-volumes.inc b/api-ref/source/v2/volumes-v2-volumes.inc
index 7e3fa0d8d94..569ca113036 100644
--- a/api-ref/source/v2/volumes-v2-volumes.inc
+++ b/api-ref/source/v2/volumes-v2-volumes.inc
@@ -185,7 +185,7 @@ Request
    - multiattach: multiattach_req
    - availability_zone: availability_zone
    - source_volid: source_volid
-   - name: name_13
+   - name: volume_name_optional
    - volume: volume
    - consistencygroup_id: consistencygroup_id_1
    - volume_type: volume_type_2
diff --git a/api-ref/source/v3/ext-backups.inc b/api-ref/source/v3/ext-backups.inc
index 8f02b00c4bb..7411edd9072 100644
--- a/api-ref/source/v3/ext-backups.inc
+++ b/api-ref/source/v3/ext-backups.inc
@@ -233,7 +233,7 @@ Request
    - project_id: project_id_path
    - backup_id: backup_id
    - restore: restore
-   - name: name_8
+   - name: volume_name_optional
    - volume_id: volume_id_6
 
 Request Example
diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index 34770646d00..3a1491ee5e4 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -1884,12 +1884,6 @@ name_6:
   in: body
   required: false
   type: string
-name_8:
-  description: |
-    The volume name.
-  in: body
-  required: false
-  type: string
 name_9:
   description: |
     The consistency group name.
@@ -2967,7 +2961,7 @@ volume_name:
   in: body
   required: true
   type: string
-volume_name_1:
+volume_name_optional:
   description: |
     The volume name.
   in: body
diff --git a/api-ref/source/v3/volume-manage.inc b/api-ref/source/v3/volume-manage.inc
index 469941d0c93..afec3da3bd2 100644
--- a/api-ref/source/v3/volume-manage.inc
+++ b/api-ref/source/v3/volume-manage.inc
@@ -47,7 +47,7 @@ Request
    - availability_zone: availability_zone
    - bootable: bootable_1
    - volume_type: volume_type
-   - name: volume_name_1
+   - name: volume_name_optional
    - host: host_mutex
    - cluster: cluster_mutex
    - ref: ref
diff --git a/api-ref/source/v3/volumes-v3-volumes.inc b/api-ref/source/v3/volumes-v3-volumes.inc
index db05e6a41a7..d09aee47a17 100644
--- a/api-ref/source/v3/volumes-v3-volumes.inc
+++ b/api-ref/source/v3/volumes-v3-volumes.inc
@@ -199,7 +199,7 @@ Request
    - multiattach: multiattach_req
    - snapshot_id: snapshot_id
    - backup_id: backup_id_1
-   - name: name_13
+   - name: volume_name_optional
    - imageRef: imageRef
    - volume_type: volume_type_2
    - metadata: metadata_10
@@ -404,7 +404,7 @@ Request
    - volume_id: volume_id_path
    - volume: volume
    - description: description_5
-   - name: name_8
+   - name: volume_name_optional
    - metadata: metadata_2
 
 Request Example