diff --git a/www/apps/api-reference/specs/admin/openapi.full.yaml b/www/apps/api-reference/specs/admin/openapi.full.yaml
index f4a66516074b7..9890edb795961 100644
--- a/www/apps/api-reference/specs/admin/openapi.full.yaml
+++ b/www/apps/api-reference/specs/admin/openapi.full.yaml
@@ -28337,7 +28337,7 @@ paths:
                       required_quantity:
                         type: number
                         title: required_quantity
-                        description: The variant's quantity.
+                        description: The number of units a single quantity is equivalent to. For example, if a customer orders one quantity of the variant, Medusa checks the availability of the quantity multiplied by the value set for `required_quantity`. When the customer orders the quantity, Medusa reserves the ordered quantity multiplied by the value set for `required_quantity`.
                       inventory_item_id:
                         type: string
                         title: inventory_item_id
@@ -28360,7 +28360,7 @@ paths:
                       required_quantity:
                         type: number
                         title: required_quantity
-                        description: The variant's quantity.
+                        description: The number of units a single quantity is equivalent to. For example, if a customer orders one quantity of the variant, Medusa checks the availability of the quantity multiplied by the value set for `required_quantity`. When the customer orders the quantity, Medusa reserves the ordered quantity multiplied by the value set for `required_quantity`.
                       inventory_item_id:
                         type: string
                         title: inventory_item_id
diff --git a/www/apps/api-reference/specs/admin/paths/admin_products_{id}_variants_inventory-items_batch.yaml b/www/apps/api-reference/specs/admin/paths/admin_products_{id}_variants_inventory-items_batch.yaml
index 1041e8b9a867a..508314a614b78 100644
--- a/www/apps/api-reference/specs/admin/paths/admin_products_{id}_variants_inventory-items_batch.yaml
+++ b/www/apps/api-reference/specs/admin/paths/admin_products_{id}_variants_inventory-items_batch.yaml
@@ -43,7 +43,14 @@ post:
                   required_quantity:
                     type: number
                     title: required_quantity
-                    description: The variant's quantity.
+                    description: >-
+                      The number of units a single quantity is equivalent to.
+                      For example, if a customer orders one quantity of the
+                      variant, Medusa checks the availability of the quantity
+                      multiplied by the value set for `required_quantity`. When
+                      the customer orders the quantity, Medusa reserves the
+                      ordered quantity multiplied by the value set for
+                      `required_quantity`.
                   inventory_item_id:
                     type: string
                     title: inventory_item_id
@@ -70,7 +77,14 @@ post:
                   required_quantity:
                     type: number
                     title: required_quantity
-                    description: The variant's quantity.
+                    description: >-
+                      The number of units a single quantity is equivalent to.
+                      For example, if a customer orders one quantity of the
+                      variant, Medusa checks the availability of the quantity
+                      multiplied by the value set for `required_quantity`. When
+                      the customer orders the quantity, Medusa reserves the
+                      ordered quantity multiplied by the value set for
+                      `required_quantity`.
                   inventory_item_id:
                     type: string
                     title: inventory_item_id
diff --git a/www/apps/api-reference/specs/store/code_samples/Shell/store_payment-collections/post.sh b/www/apps/api-reference/specs/store/code_samples/Shell/store_payment-collections/post.sh
index fc07b9041c134..075f748a9aba8 100644
--- a/www/apps/api-reference/specs/store/code_samples/Shell/store_payment-collections/post.sh
+++ b/www/apps/api-reference/specs/store/code_samples/Shell/store_payment-collections/post.sh
@@ -2,8 +2,5 @@ curl -X POST '{backend_url}/store/payment-collections' \
 -H 'Content-Type: application/json' \ \
 -H 'x-publishable-api-key: {your_publishable_api_key}'
 --data-raw '{
-  "cart_id": "{value}",
-  "region_id": "{value}",
-  "currency_code": "{value}",
-  "amount": 8468325826822144
+  "cart_id": "{value}"
 }'
\ No newline at end of file
diff --git a/www/apps/api-reference/specs/store/openapi.full.yaml b/www/apps/api-reference/specs/store/openapi.full.yaml
index 03e2e02ddad47..9857f9d85145a 100644
--- a/www/apps/api-reference/specs/store/openapi.full.yaml
+++ b/www/apps/api-reference/specs/store/openapi.full.yaml
@@ -3126,10 +3126,7 @@ paths:
             -H 'Content-Type: application/json' \ \
             -H 'x-publishable-api-key: {your_publishable_api_key}'
             --data-raw '{
-              "cart_id": "{value}",
-              "region_id": "{value}",
-              "currency_code": "{value}",
-              "amount": 8468325826822144
+              "cart_id": "{value}"
             }'
       tags:
         - Payment Collections