diff --git a/api-ref/source/v2/os-vol-transfer-v2.inc b/api-ref/source/v2/os-vol-transfer-v2.inc
index bbfffaf8077..e02e558cdd0 100644
--- a/api-ref/source/v2/os-vol-transfer-v2.inc
+++ b/api-ref/source/v2/os-vol-transfer-v2.inc
@@ -27,6 +27,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - auth_key: auth_key
+   - transfer: transfer
    - transfer_id: transfer_id
    - project_id: project_id_path
 
@@ -72,6 +73,8 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
+   - project_id: project_id_path
+   - transfer: transfer
    - name: name
    - volume_id: volume_id
    - project_id: project_id_path
diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index ff9e454cb56..843dec23800 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -1586,6 +1586,12 @@ totalVolumesUsed:
   in: body
   required: true
   type: integer
+transfer:
+  description: |
+    The volume transfer object.
+  in: body
+  required: true
+  type: object
 updated:
   description: |
     The date and time stamp when the extension was
diff --git a/api-ref/source/v3/os-vol-transfer-v3.inc b/api-ref/source/v3/os-vol-transfer-v3.inc
index dc4eda5cf94..2b17f5d5ce0 100644
--- a/api-ref/source/v3/os-vol-transfer-v3.inc
+++ b/api-ref/source/v3/os-vol-transfer-v3.inc
@@ -41,6 +41,7 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
+   - transfer: transfer
    - volume_id: volume_id
    - id: id
    - links: links