diff --git a/api-ref/source/baremetal-api-v1-portgroups.inc b/api-ref/source/baremetal-api-v1-portgroups.inc
index d1a3d22337..6149ff054f 100644
--- a/api-ref/source/baremetal-api-v1-portgroups.inc
+++ b/api-ref/source/baremetal-api-v1-portgroups.inc
@@ -83,6 +83,7 @@ Request
 
     - node_uuid: node_uuid
     - address: portgroup_address
+    - name: portgroup_name
 
 **Example Portgroup creation request:**
 
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index cb8f290d1a..17344b122f 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -829,7 +829,7 @@ portgroup_address:
     Physical hardware address of this Portgroup, typically the hardware
     MAC address.
   in: body
-  required: true
+  required: false
   type: string
 portgroup_internal_info:
   description: |