diff --git a/api-ref/source/v2/hosts.inc b/api-ref/source/v2/hosts.inc
index 181505680f2..a77b58de0ca 100644
--- a/api-ref/source/v2/hosts.inc
+++ b/api-ref/source/v2/hosts.inc
@@ -41,7 +41,7 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
-   - service-status: service_status
+   - service-status: host_service_status
    - service: host_service
    - zone: availability_zone_3
    - service-state: service_state
diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index 170a19cda5b..477b3348b24 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -687,6 +687,12 @@ host_service:
   in: body
   required: true
   type: string
+host_service_status:
+  description: |
+    The status of the service. One of ``available`` or ``unavailable``.
+  in: body
+  required: true
+  type: string
 id:
   description: |
     The UUID of the volume transfer.
@@ -1539,7 +1545,7 @@ service_state:
   type: string
 service_status:
   description: |
-    The status of the service. One of ``available`` or ``unavailable``.
+    The status of the service. One of ``enabled`` or ``disabled``.
   in: body
   required: true
   type: string
diff --git a/api-ref/source/v3/hosts.inc b/api-ref/source/v3/hosts.inc
index 273138b7567..8e9e421291e 100644
--- a/api-ref/source/v3/hosts.inc
+++ b/api-ref/source/v3/hosts.inc
@@ -42,7 +42,7 @@ Response Parameters
 .. rest_parameters:: parameters.yaml
 
    - hosts: hosts
-   - service-status: service_status
+   - service-status: host_service_status
    - service: host_service
    - zone: availability_zone_required
    - service-state: service_state
diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index 400cd2a7b46..bea29d7dc4d 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -1355,6 +1355,12 @@ host_service:
   in: body
   required: true
   type: string
+host_service_status:
+  description: |
+    The status of the service. One of ``available`` or ``unavailable``.
+  in: body
+  required: true
+  type: string
 hosts:
   description: |
     A OpenStack Block Storage host.