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

@@ -2,9 +2,9 @@ type: object
 description: The region's details.
 x-schemaName: AdminRegion
 required:
-  - id
   - name
   - currency_code
+  - id
 properties:
   id:
     type: string
@@ -18,15 +18,16 @@ properties:
     type: string
     title: currency_code
     description: The region's currency code.
+    example: usd
   automatic_taxes:
     type: boolean
     title: automatic_taxes
-    description: The region's automatic taxes.
+    description: Whether taxes are applied automatically during checkout.
   countries:
     type: array
     description: The region's countries.
     items:
-      $ref: ./BaseRegionCountry.yaml
+      $ref: ./AdminRegionCountry.yaml
   payment_providers:
     type: array
     description: The region's payment providers.
@@ -34,14 +35,14 @@ properties:
       $ref: ./AdminPaymentProvider.yaml
   metadata:
     type: object
-    description: The region's metadata.
+    description: The region's metadata, can hold custom key-value pairs.
   created_at:
     type: string
     format: date-time
     title: created_at
-    description: The region's created at.
+    description: The date the region was created.
   updated_at:
     type: string
     format: date-time
     title: updated_at
-    description: The region's updated at.
+    description: The date the region was updated.