diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index 11e8c374f49..872156dabc4 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -1032,14 +1032,16 @@ mountpoint:
   in: body
   required: true
   type: string
-multiattach:
+multiattach_req:
   description: |
     To enable this volume to attach to more than one
     server, set this value to ``true``. Default is ``false``.
+    Note that support for multiattach volumes depends on the volume
+    type being used.
   in: body
   required: false
   type: boolean
-multiattach_1:
+multiattach_resp:
   description: |
     If true, this volume can attach to more than one
     instance.
diff --git a/api-ref/source/v2/volumes-v2-volumes.inc b/api-ref/source/v2/volumes-v2-volumes.inc
index 0e7146d6cf3..a8bdff34f72 100644
--- a/api-ref/source/v2/volumes-v2-volumes.inc
+++ b/api-ref/source/v2/volumes-v2-volumes.inc
@@ -106,7 +106,7 @@ Response Parameters
    - status: status_3
    - volume_image_metadata: volume_image_metadata
    - description: description
-   - multiattach: multiattach
+   - multiattach: multiattach_resp
    - source_volid: source_volid
    - consistencygroup_id: consistencygroup_id
    - os-vol-mig-status-attr:name_id: os-vol-mig-status-attr:name_id
@@ -175,7 +175,7 @@ Request
    - size: size
    - description: description_9
    - imageRef: imageRef
-   - multiattach: multiattach
+   - multiattach: multiattach_req
    - availability_zone: availability_zone
    - source_volid: source_volid
    - name: name_13
@@ -215,7 +215,7 @@ Response Parameters
    - metadata: metadata
    - status: status_3
    - description: description
-   - multiattach: multiattach
+   - multiattach: multiattach_resp
    - source_volid: source_volid
    - volume: volume
    - consistencygroup_id: consistencygroup_id
@@ -322,7 +322,7 @@ Response Parameters
    - status: status_3
    - volume_image_metadata: volume_image_metadata
    - description: description
-   - multiattach: multiattach
+   - multiattach: multiattach_resp
    - source_volid: source_volid
    - volume: volume
    - consistencygroup_id: consistencygroup_id
@@ -394,7 +394,7 @@ Response Parameters
    - metadata: metadata_3
    - status: status_3
    - description: description
-   - multiattach: multiattach
+   - multiattach: multiattach_resp
    - source_volid: source_volid
    - volume: volume
    - consistencygroup_id: consistencygroup_id
diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index 03d75d642f6..23c371f96c8 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -1710,14 +1710,16 @@ mountpoint:
   in: body
   required: true
   type: string
-multiattach:
+multiattach_req:
   description: |
     To enable this volume to attach to more than one
     server, set this value to ``true``. Default is ``false``.
+    Note that support for multiattach volumes depends on the volume
+    type being used.
   in: body
   required: false
   type: boolean
-multiattach_1:
+multiattach_resp:
   description: |
     If true, this volume can attach to more than one
     instance.
diff --git a/api-ref/source/v3/volumes-v3-volumes.inc b/api-ref/source/v3/volumes-v3-volumes.inc
index 32d31ea109c..ea34bf23c3d 100644
--- a/api-ref/source/v3/volumes-v3-volumes.inc
+++ b/api-ref/source/v3/volumes-v3-volumes.inc
@@ -113,7 +113,7 @@ Response Parameters
    - status: status_3
    - volume_image_metadata: volume_image_metadata
    - description: description_9
-   - multiattach: multiattach
+   - multiattach: multiattach_resp
    - source_volid: source_volid
    - consistencygroup_id: consistencygroup_id
    - os-vol-mig-status-attr:name_id: os-vol-mig-status-attr:name_id
@@ -186,7 +186,7 @@ Request
    - availability_zone: availability_zone
    - source_volid: source_volid
    - description: description_5
-   - multiattach: multiattach
+   - multiattach: multiattach_req
    - snapshot_id: snapshot_id
    - backup_id: backup_id_1
    - name: name_13
@@ -223,7 +223,7 @@ Response Parameters
    - metadata: metadata
    - status: status_3
    - description: description_9
-   - multiattach: multiattach
+   - multiattach: multiattach_resp
    - source_volid: source_volid
    - volume: volume
    - consistencygroup_id: consistencygroup_id
@@ -337,7 +337,7 @@ Response Parameters
    - status: status_3
    - volume_image_metadata: volume_image_metadata
    - description: description_9
-   - multiattach: multiattach
+   - multiattach: multiattach_resp
    - source_volid: source_volid
    - volume: volume
    - consistencygroup_id: consistencygroup_id
@@ -410,7 +410,7 @@ Response Parameters
    - metadata: metadata
    - status: status_3
    - description: description_9
-   - multiattach: multiattach
+   - multiattach: multiattach_resp
    - source_volid: source_volid
    - volume: volume
    - consistencygroup_id: consistencygroup_id