diff --git a/api-ref/source/os-aggregates.inc b/api-ref/source/os-aggregates.inc
index 05aadeb437..6e85449818 100644
--- a/api-ref/source/os-aggregates.inc
+++ b/api-ref/source/os-aggregates.inc
@@ -26,6 +26,8 @@ Request
 .. rest_parameters:: parameters.yaml
 
   - tenant_id: tenant_id
+  - name: aggregate_name
+  - availability_zone: availability_zone
 
 **Example Create Aggregate: JSON request**
 
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 4eb75a67e0..2be49eb981 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -34,6 +34,12 @@ aggregate_id:
   in: path
   required: true
   type: string
+aggregate_name:
+  description: |
+    The name of the aggregate.
+  in: body
+  required: true
+  type: string
 alias_1:
   description: |
     An alias for the extension name. For example, ``os-server-external-events``.