diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index 477b3348b24..1b7fde4db00 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -665,7 +665,7 @@ has_dependent_backups:
 host:
   description: |
     The OpenStack Block Storage host where the
-    existing volume resides. Host format is ``host@backend``.
+    existing volume resides.
   in: body
   required: true
   type: string
@@ -677,7 +677,8 @@ host_name:
   type: string
 host_name_1:
   description: |
-    The name of the host that hosts the storage backend.
+    The name of the host that hosts the storage backend,
+    may take the format of ``host@backend``.
   in: body
   required: true
   type: string
diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index bea29d7dc4d..eccd50f780d 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -1314,7 +1314,7 @@ has_dependent_backups:
 host:
   description: |
     The OpenStack Block Storage host where the
-    existing volume resides. Host format is ``host@backend``.
+    existing volume resides.
   in: body
   required: true
   type: object
@@ -1333,7 +1333,8 @@ host_name:
   type: string
 host_name_backend:
   description: |
-    The name of the host that hosts the storage backend.
+    The name of the host that hosts the storage backend,
+    may take the format of ``host@backend``.
   in: body
   required: true
   type: string