diff --git a/api-ref/source/flavors.inc b/api-ref/source/flavors.inc
index 7f6eaaedac59..6ef3feef1c7e 100644
--- a/api-ref/source/flavors.inc
+++ b/api-ref/source/flavors.inc
@@ -74,7 +74,7 @@ Request
 
    - flavor: flavor
    - name: flavor_name
-   - id: flavor_id_body
+   - id: flavor_id_body_create
    - ram: flavor_ram
    - disk: flavor_disk
    - vcpus: flavor_cpus
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index f775ad9b1674..6e9bbe7939dd 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -1914,6 +1914,13 @@ flavor_id_body:
   in: body
   required: true
   type: string
+flavor_id_body_create:
+  description: |
+    The ID of the flavor. While people often make this look like an int, this
+    is really a string. If not provided, this defaults to a uuid.
+  in: body
+  required: false
+  type: string
 flavor_is_public:
   description: |
     Whether the flavor is public (available to all projects) or scoped