diff --git a/api-ref/source/v3/attachments.inc b/api-ref/source/v3/attachments.inc
index 7162048e7..bcc5dd4c5 100644
--- a/api-ref/source/v3/attachments.inc
+++ b/api-ref/source/v3/attachments.inc
@@ -224,7 +224,7 @@ Request
 
    - project_id: project_id_path
    - attachment_id: attachment_id_1
-   - connector: connector
+   - connector: connector_1
 
 Request Example
 ---------------
diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index bf4c6f8d3..b3a113f72 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -548,6 +548,14 @@ connector:
   in: body
   required: false
   type: object
+connector_1:
+  description: |
+    The ``connector`` object. The internal structure of connector depends on
+    the volume driver implementation. For details about the required elements
+    in the structure, see the documentation for the volume driver.
+  in: body
+  required: true
+  type: object
 consistencygroup_id:
   description: |
     The UUID of the consistency group.