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

@@ -1,5 +1,5 @@
 type: object
-description: The order's customer.
+description: The customer's details.
 x-schemaName: AdminCustomer
 required:
   - has_account
@@ -12,19 +12,19 @@ required:
   - last_name
   - addresses
 properties:
+  id:
+    type: string
+    title: id
+    description: The customer's ID.
   has_account:
     type: boolean
     title: has_account
-    description: The customer's has account.
+    description: Whether the customer is registered.
   groups:
     type: array
     description: The customer's groups.
     items:
       $ref: ./AdminCustomerGroup.yaml
-  id:
-    type: string
-    title: id
-    description: The customer's ID.
   email:
     type: string
     title: email
@@ -33,11 +33,11 @@ properties:
   default_billing_address_id:
     type: string
     title: default_billing_address_id
-    description: The customer's default billing address id.
+    description: The ID of the address used as the default billing address.
   default_shipping_address_id:
     type: string
     title: default_shipping_address_id
-    description: The customer's default shipping address id.
+    description: The ID of the address used as the default shipping address.
   company_name:
     type: string
     title: company_name
@@ -61,23 +61,23 @@ properties:
     description: The customer's phone.
   metadata:
     type: object
-    description: The customer's metadata.
+    description: The customer's metadata, used to store custom key-value pairs.
   created_by:
     type: string
     title: created_by
-    description: The customer's created by.
-  deleted_at:
-    type: string
-    format: date-time
-    title: deleted_at
-    description: The customer's deleted at.
+    description: The ID of the user that created this customer, if available.
   created_at:
     type: string
     format: date-time
     title: created_at
-    description: The customer's created at.
+    description: The customer's creation date.
   updated_at:
     type: string
     format: date-time
     title: updated_at
-    description: The customer's updated at.
+    description: The customer's update date.
+  deleted_at:
+    type: string
+    format: date-time
+    title: deleted_at
+    description: The customer's deletion date.