diff --git a/api-ref/source/v2/hosts.inc b/api-ref/source/v2/hosts.inc
index dca4cfd2a99..6140f40a04f 100644
--- a/api-ref/source/v2/hosts.inc
+++ b/api-ref/source/v2/hosts.inc
@@ -48,7 +48,11 @@ Show Host Details
 
 .. rest_method:: GET /v2/{admin_tenant_id}/os-hosts/{host_name}
 
-Shows details for a host.
+Shows volume and snapshot details for a cinder-volume host.
+
+*Note:* This API is meant specifically for cinder-volume hosts only.
+It is not valid against other Cinder service hosts or hosts where the
+cinder-volume service has been disabled.
 
 Normal response codes: 200
 
diff --git a/api-ref/source/v3/hosts.inc b/api-ref/source/v3/hosts.inc
index b5046096653..00ae6faa602 100644
--- a/api-ref/source/v3/hosts.inc
+++ b/api-ref/source/v3/hosts.inc
@@ -49,7 +49,11 @@ Show Host Details for a project
 
 .. rest_method:: GET /v3/{admin_project_id}/os-hosts/{host_name}
 
-Shows details for a host.
+Shows volume and snapshot details for a cinder-volume host.
+
+*Note:* This API is meant specifically for cinder-volume hosts only.
+It is not valid against other Cinder service hosts or hosts where the
+cinder-volume service has been disabled.
 
 Normal response codes: 200