chore(docs): Updated API Reference (v2) (#9437)

Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action

Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>

www/apps/api-reference/specs/admin/components/schemas/UpdateCartData.yaml

@@ -1,36 +1,41 @@
 type: object
-description: SUMMARY
+description: The details to update in a cart.
 x-schemaName: UpdateCartData
 properties:
   region_id:
     type: string
     title: region_id
-    description: The cart's region id.
+    description: >-
+      The ID of the associated region. This can affect the prices and currency
+      code of the cart.
   customer_id:
     type: string
     title: customer_id
-    description: The cart's customer id.
+    description: The ID of the customer that the cart belongs to.
   sales_channel_id:
     type: string
     title: sales_channel_id
-    description: The cart's sales channel id.
+    description: >-
+      The ID of the associated sales channel. Only products available in this
+      channel can be added to the cart.
   email:
     type: string
     title: email
-    description: The cart's email.
+    description: The email of the customer that the cart belongs to.
     format: email
   currency_code:
     type: string
     title: currency_code
     description: The cart's currency code.
+    example: usd
   shipping_address_id:
     type: string
     title: shipping_address_id
-    description: The cart's shipping address id.
+    description: The ID of the cart's shipping address.
   billing_address_id:
     type: string
     title: billing_address_id
-    description: The cart's billing address id.
+    description: The ID of the cart's billing address.
   billing_address:
     oneOf:
       - $ref: ./CreateAddress.yaml
@@ -41,4 +46,4 @@ properties:
       - $ref: ./UpdateAddress.yaml
   metadata:
     type: object
-    description: The cart's metadata.
+    description: The cart's metadata, ca hold custom key-value pairs.