diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index 3692ec8cfb3..170a19cda5b 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -1064,13 +1064,7 @@ migration_policy:
   type: string
 migration_status:
   description: |
-    The volume migration status.
-  in: body
-  required: true
-  type: string
-migration_status_1:
-  description: |
-    The volume migration status.
+    The volume migration status. Admin only.
   in: body
   required: false
   type: string
diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index b154ee543ed..400cd2a7b46 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -1797,16 +1797,10 @@ migration_policy:
   type: string
 migration_status:
   description: |
-    The volume migration status.
+    The volume migration status. Admin only.
   in: body
   required: false
   type: string
-migration_status_req:
-  description: |
-    The volume migration status.
-  in: body
-  required: true
-  type: string
 mountpoint:
   description: |
     The attaching mount point.
diff --git a/api-ref/source/v3/volume-manage.inc b/api-ref/source/v3/volume-manage.inc
index 1a28e3c0108..eb0dd457626 100644
--- a/api-ref/source/v3/volume-manage.inc
+++ b/api-ref/source/v3/volume-manage.inc
@@ -70,7 +70,7 @@ Response
 
    - volume: volume
    - status: status_vol
-   - migration_status: migration_status_req
+   - migration_status: migration_status
    - user_id: user_id
    - attachments: attachments
    - links: links_vol
diff --git a/api-ref/source/v3/volumes-v3-volumes.inc b/api-ref/source/v3/volumes-v3-volumes.inc
index e6c0cc96f75..487da8d1515 100644
--- a/api-ref/source/v3/volumes-v3-volumes.inc
+++ b/api-ref/source/v3/volumes-v3-volumes.inc
@@ -221,7 +221,7 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
-   - migration_status: migration_status_req
+   - migration_status: migration_status
    - attachments: attachments
    - links: links_vol
    - availability_zone: availability_zone
@@ -344,7 +344,7 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
-   - migration_status: migration_status_req
+   - migration_status: migration_status
    - attachments: attachments
    - links: links_vol
    - availability_zone: availability_zone
@@ -424,7 +424,7 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
-   - migration_status: migration_status_req
+   - migration_status: migration_status
    - attachments: attachments
    - links: links_vol
    - availability_zone: availability_zone