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

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

Co-authored-by: Oli Juhl <59018053+olivermrbl@users.noreply.github.com>

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

@@ -1,5 +1,5 @@
 type: object
-description: SUMMARY
+description: The region's details.
 x-schemaName: AdminCreateRegion
 required:
   - name
@@ -13,28 +13,31 @@ properties:
     type: string
     title: currency_code
     description: The region's currency code.
+    example: usd
   countries:
     type: array
     description: The region's countries.
     items:
       type: string
       title: countries
-      description: The country's countries.
+      description: A country code.
+      example: us
   automatic_taxes:
     type: boolean
     title: automatic_taxes
-    description: The region's automatic taxes.
+    description: Whether taxes are calculated automatically during checkout in this region.
   is_tax_inclusive:
     type: boolean
     title: is_tax_inclusive
-    description: The region's is tax inclusive.
+    description: Whether prices in this region are tax inclusive.
   payment_providers:
     type: array
-    description: The region's payment providers.
+    description: The payment providers enabled in this region.
     items:
       type: string
       title: payment_providers
-      description: The payment provider's payment providers.
+      description: A payment provider's ID.
+      example: pp_stripe_stripe
   metadata:
     type: object
-    description: The region's metadata.
+    description: The region's metadata, used to store custom key-value pairs.