diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index ab68c0ec942..465dfa60d81 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -1744,6 +1744,14 @@ volume_id_6:
   in: body
   required: false
   type: string
+volume_image_metadata:
+  description: |
+    List of image metadata entries.  Only included for volumes that were
+    created from an image, or from a snapshot of a volume originally created
+    from an image.
+  in: body
+  required: false
+  type: object
 volume_name:
   description: |
     The volume name.
diff --git a/api-ref/source/v2/volumes-v2-volumes.inc b/api-ref/source/v2/volumes-v2-volumes.inc
index ff5a8e62944..0e7146d6cf3 100644
--- a/api-ref/source/v2/volumes-v2-volumes.inc
+++ b/api-ref/source/v2/volumes-v2-volumes.inc
@@ -104,6 +104,7 @@ Response Parameters
    - os-vol-mig-status-attr:migstat: os-vol-mig-status-attr:migstat
    - metadata: metadata
    - status: status_3
+   - volume_image_metadata: volume_image_metadata
    - description: description
    - multiattach: multiattach
    - source_volid: source_volid
@@ -319,6 +320,7 @@ Response Parameters
    - os-vol-mig-status-attr:migstat: os-vol-mig-status-attr:migstat
    - metadata: metadata
    - status: status_3
+   - volume_image_metadata: volume_image_metadata
    - description: description
    - multiattach: multiattach
    - source_volid: source_volid
diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index e96297b0b82..a01e3846fca 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -2758,6 +2758,14 @@ volume_id_7:
   in: body
   required: true
   type: string
+volume_image_metadata:
+  description: |
+    List of image metadata entries.  Only included for volumes that were
+    created from an image, or from a snapshot of a volume originally created
+    from an image.
+  in: body
+  required: false
+  type: object
 volume_name:
   description: |
     The volume name.
diff --git a/api-ref/source/v3/volumes-v3-volumes.inc b/api-ref/source/v3/volumes-v3-volumes.inc
index e696dcc392d..44960b78d6d 100644
--- a/api-ref/source/v3/volumes-v3-volumes.inc
+++ b/api-ref/source/v3/volumes-v3-volumes.inc
@@ -111,6 +111,7 @@ Response Parameters
    - os-vol-mig-status-attr:migstat: os-vol-mig-status-attr:migstat
    - metadata: metadata
    - status: status_3
+   - volume_image_metadata: volume_image_metadata
    - description: description
    - multiattach: multiattach
    - source_volid: source_volid
@@ -333,6 +334,7 @@ Response Parameters
    - os-vol-mig-status-attr:migstat: os-vol-mig-status-attr:migstat
    - metadata: metadata
    - status: status_3
+   - volume_image_metadata: volume_image_metadata
    - description: description
    - multiattach: multiattach
    - source_volid: source_volid