diff --git a/api-ref/source/v3/attachments.inc b/api-ref/source/v3/attachments.inc
index 06dbfcf44a4..7b9845965ea 100644
--- a/api-ref/source/v3/attachments.inc
+++ b/api-ref/source/v3/attachments.inc
@@ -256,6 +256,7 @@ Request
    - instance_uuid: instance_uuid_1
    - connector: connector
    - volume_uuid: volume_id_7
+   - mode: attach_mode_1
 
 Request Example
 ---------------
diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index 80b8122c27a..5e5bb598b1c 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -444,6 +444,14 @@ attach_mode:
   in: body
   required: true
   type: string
+attach_mode_1:
+  description: |
+    The attach mode of attachment, acceptable values are
+    read-only ('ro') and read-and-write ('rw').
+  in: body
+  required: false
+  type: string
+  min_version: 3.54
 attach_status:
   description: |
     The volume attach status.