diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index b5c9ed387..e50870f3d 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -7046,6 +7046,13 @@ subnet-gateway_ip-request:
   in: body
   required: false
   type: string
+subnet-gateway_ip-update-request:
+  description: |
+    Gateway IP of this subnet. If the value is ``null`` that implies no
+    gateway is associated with the subnet.
+  in: body
+  required: false
+  type: string
 subnet-host_routes:
   description: |
     Additional routes for the subnet. A list of dictionaries with
diff --git a/api-ref/source/v2/subnets.inc b/api-ref/source/v2/subnets.inc
index 1838e884b..bc301461b 100644
--- a/api-ref/source/v2/subnets.inc
+++ b/api-ref/source/v2/subnets.inc
@@ -463,7 +463,7 @@ Request
    - dns_nameservers: subnet-dns_nameservers-request
    - allocation_pools: subnet-allocation_pools-request
    - host_routes: subnet-host_routes-request
-   - gateway_ip: subnet-gateway_ip-request
+   - gateway_ip: subnet-gateway_ip-update-request
    - description: description-request
    - service_types: subnet-service_types-optional
    - segment_id: subnet-segment_id-request