diff --git a/api-ref/source/os-volume-attachments.inc b/api-ref/source/os-volume-attachments.inc
index 575014a2148e..1f5042fe3988 100644
--- a/api-ref/source/os-volume-attachments.inc
+++ b/api-ref/source/os-volume-attachments.inc
@@ -117,7 +117,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
   - server_id: server_id_path
-  - volume_id: volume_id
+  - volume_id: volume_id_attached_path
 
 Response
 --------
@@ -189,7 +189,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
   - server_id: server_id_path
-  - volume_id: volume_id
+  - volume_id: volume_id_to_detach_path
 
 Response
 --------
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 9a6820a44187..0a3a146236fa 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -337,12 +337,24 @@ tenant_id:
   in: path
   required: true
   type: string
+volume_id_attached_path:
+  description: |
+    The UUID of the attached volume.
+  in: path
+  required: true
+  type: string
 volume_id_path:
   description: |
     The unique ID for a volume.
   in: path
   required: true
   type: string
+volume_id_to_detach_path:
+  description: |
+    The UUID of the volume to detach.
+  in: path
+  required: true
+  type: string
 
 # variables in query
 access_ip_v4_query_server: