diff --git a/api-ref/source/v2/capabilities-v2.inc b/api-ref/source/v2/capabilities-v2.inc
index c3a413a7e8e..6f3546c2d3e 100644
--- a/api-ref/source/v2/capabilities-v2.inc
+++ b/api-ref/source/v2/capabilities-v2.inc
@@ -10,9 +10,10 @@ Shows capabilities for a storage back end.
 Show back-end capabilities
 ==========================
 
-.. rest_method::  GET /v2/{tenant_id}/capabilities/{hostname}
+.. rest_method::  GET /v2/{tenant_id}/capabilities/{host}
 
-Shows capabilities for a storage back end.
+Shows capabilities for a storage back end on the host.
+The ``host`` takes the form of ``hostname@volume_backend_name``.
 
 
 Normal response codes: 200
diff --git a/api-ref/source/v2/samples/backend-capabilities-response.json b/api-ref/source/v2/samples/backend-capabilities-response.json
index e89abe48537..dcf213d2445 100644
--- a/api-ref/source/v2/samples/backend-capabilities-response.json
+++ b/api-ref/source/v2/samples/backend-capabilities-response.json
@@ -1,7 +1,7 @@
 {
     "namespace": "OS::Storage::Capabilities::fake",
     "vendor_name": "OpenStack",
-    "volume_backend_name": "lvm",
+    "volume_backend_name": "lvmdriver-1",
     "pool_name": "pool",
     "driver_version": "2.0.0",
     "storage_protocol": "iSCSI",
diff --git a/api-ref/source/v3/capabilities-v3.inc b/api-ref/source/v3/capabilities-v3.inc
index 84b8cde6127..3dce1ba0d24 100644
--- a/api-ref/source/v3/capabilities-v3.inc
+++ b/api-ref/source/v3/capabilities-v3.inc
@@ -10,10 +10,10 @@ Shows capabilities for a storage back end.
 Show all back-end capabilities
 ==============================
 
-.. rest_method::  GET /v3/{tenant_id}/capabilities/{hostname}
-
-Shows capabilities for a storage back end.
+.. rest_method::  GET /v3/{tenant_id}/capabilities/{host}
 
+Shows capabilities for a storage back end on the host.
+The ``host`` takes the form of ``hostname@volume_backend_name``.
 
 Normal response codes: 200
 Error response codes:
diff --git a/api-ref/source/v3/samples/backend-capabilities-response.json b/api-ref/source/v3/samples/backend-capabilities-response.json
index a72a238156c..03604a5e68a 100644
--- a/api-ref/source/v3/samples/backend-capabilities-response.json
+++ b/api-ref/source/v3/samples/backend-capabilities-response.json
@@ -1,7 +1,7 @@
 {
     "namespace": "OS::Storage::Capabilities::fake",
     "vendor_name": "OpenStack",
-    "volume_backend_name": "lvm",
+    "volume_backend_name": "lvmdriver-1",
     "pool_name": "pool",
     "driver_version": "2.0.0",
     "storage_protocol": "iSCSI",