diff --git a/api-ref/source/os-volume-attachments.inc b/api-ref/source/os-volume-attachments.inc
index 47d9a41a4776..157ed5b974b2 100644
--- a/api-ref/source/os-volume-attachments.inc
+++ b/api-ref/source/os-volume-attachments.inc
@@ -33,7 +33,7 @@ Response
 
   - volumeAttachments: volumeAttachments
   - device: device_resp
-  - id: attachment_id_resp
+  - id: attachment_id_required
   - serverId: server_id
   - volumeId: volumeId_resp
 
@@ -78,7 +78,7 @@ Response
 
   - volumeAttachment: volumeAttachment
   - device: device_resp
-  - id: attachment_id_resp
+  - id: attachment_id_required
   - serverId: server_id
   - volumeId: volumeId_resp
 
@@ -113,7 +113,7 @@ Response
 
   - volumeAttachment: volumeAttachment
   - device: device_resp
-  - id: attachment_id_resp
+  - id: attachment_id_required
   - serverId: server_id
   - volumeId: volumeId_resp
 
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index c63f45d25cdb..5d5f2ba15b0a 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -991,6 +991,12 @@ attachment_device_resp:
   in: body
   required: false
   type: string
+attachment_id_required:
+  description: |
+    The UUID of the attachment.
+  in: body
+  required: true
+  type: string
 attachment_id_resp:
   description: |
     The UUID of the attachment.