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/AdminUpdateStockLocation.yaml

@@ -1,5 +1,5 @@
 type: object
-description: SUMMARY
+description: The properties to update in a stock location.
 x-schemaName: AdminUpdateStockLocation
 properties:
   name:
@@ -8,7 +8,9 @@ properties:
     description: The stock location's name.
   address:
     type: object
-    description: The stock location's address.
+    description: >-
+      The stock location's address. Pass this property if you're creating a new
+      address to associate with the location.
     required:
       - address_1
       - country_code
@@ -16,11 +18,11 @@ properties:
       address_1:
         type: string
         title: address_1
-        description: The address's address 1.
+        description: The address's first line.
       address_2:
         type: string
         title: address_2
-        description: The address's address 2.
+        description: The address's second line.
       company:
         type: string
         title: company
@@ -33,6 +35,7 @@ properties:
         type: string
         title: country_code
         description: The address's country code.
+        example: us
       phone:
         type: string
         title: phone
@@ -48,7 +51,9 @@ properties:
   address_id:
     type: string
     title: address_id
-    description: The stock location's address id.
+    description: >-
+      The ID of an existing stock location address to associate the stock
+      location with.
   metadata:
     type: object
-    description: The stock location's metadata.
+    description: The stock location's metadata, can hold custom key-value pairs.