diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index 0ac55dec6..4a64aa907 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -5114,7 +5114,17 @@ segmentation_id:
   type: integer
 segmentation_type:
   description: |
-    The segmentation type for the subport.
+    The segmentation type for the subport. Possible values include ``vlan``
+    and ``inherit``. When ``inherit`` is specified, a port gets its
+    segmentation type from the network its connected to.
+  in: body
+  required: true
+  type: string
+segmentation_type-request:
+  description: |
+    The segmentation type for the subport. Possible values include ``vlan``
+    and ``inherit``. When ``inherit`` is specified, a port gets its
+    segmentation type from the network its connected to.
   in: body
   required: false
   type: string
diff --git a/api-ref/source/v2/trunk.inc b/api-ref/source/v2/trunk.inc
index ed08981b5..06d9c01cb 100644
--- a/api-ref/source/v2/trunk.inc
+++ b/api-ref/source/v2/trunk.inc
@@ -157,7 +157,7 @@ Request
 
    - trunk_id: trunk_id
    - segmentation_id: segmentation_id
-   - segmentation_type: segmentation_type
+   - segmentation_type: segmentation_type-request
    - port_id: port_id_subport
 
 Request Example