fixes

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

@@ -79,11 +79,7 @@ properties:
     title: updated_at
     description: The claim's update date.
   order:
-    type: string
-    title: order
-    description: The order's details.
-    externalDocs:
-      url: '#pagination'
+    $ref: ./AdminOrder.yaml
   type:
     type: string
     description: The claim's type.

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

@@ -6,10 +6,6 @@ required:
   - claim
 properties:
   order:
-    type: string
-    title: order
-    description: The order change's order.
-    externalDocs:
-      url: '#pagination'
+    $ref: ./Order.yaml
   claim:
     $ref: ./AdminClaim.yaml

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

@@ -1,5 +1,5 @@
 type: object
-description: The shipping option's type.
+description: The shipping option's details.
 x-schemaName: AdminCreateShippingOption
 required:
   - label

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

@@ -1,5 +1,5 @@
 type: object
-description: The rule's rules.
+description: The details of the shipping option rule.
 x-schemaName: AdminCreateShippingOptionRule
 required:
   - operator
@@ -8,7 +8,7 @@ required:
 properties:
   operator:
     type: string
-    description: The rule's operator.
+    description: The operator used to check whether a rule applies.
     enum:
       - gt
       - lt
@@ -21,15 +21,18 @@ properties:
   attribute:
     type: string
     title: attribute
-    description: The rule's attribute.
+    description: The name of a property or table that the rule applies to.
+    example: customer_group
   value:
     oneOf:
       - type: string
         title: value
-        description: The rule's value.
+        description: A value of the attribute that enables this rule.
+        example: cusgroup_123
       - type: array
-        description: The rule's value.
+        description: Values of the attribute that enable this rule.
         items:
           type: string
           title: value
-          description: The value's details.
+          description: A value of the attribute that enables this rule.
+          example: cusgroup_123

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

@@ -95,11 +95,7 @@ properties:
     title: deleted_at
     description: The date the exchange was deleted.
   order:
-    type: string
-    title: order
-    description: The order's details.
-    externalDocs:
-      url: '#pagination'
+    $ref: ./AdminOrder.yaml
   allow_backorder:
     type: boolean
     title: allow_backorder

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

@@ -6,10 +6,7 @@ required:
   - exchange
 properties:
   order:
-    type: string
-    title: order
-    description: The order change's order.
-    externalDocs:
-      url: '#pagination'
+    description: The details of the associated order.
+    $ref: ./Order.yaml
   exchange:
     $ref: ./AdminExchange.yaml

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

@@ -5,10 +5,4 @@ required:
   - order
 properties:
   order:
-    type: string
-    title: order
-    description: >-
-      A preview of an order if a change, such as exchange, return, edit, or
-      claim is applied on it.
-    externalDocs:
-      url: '#pagination'
+    $ref: ./AdminOrderPreview.yaml

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

@@ -5,8 +5,4 @@ required:
   - order
 properties:
   order:
-    type: string
-    title: order
-    description: The order's details.
-    externalDocs:
-      url: '#pagination'
+    $ref: ./AdminOrder.yaml

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

@@ -6,10 +6,6 @@ required:
   - return
 properties:
   order:
-    type: string
-    title: order
-    description: The order change's order.
-    externalDocs:
-      url: '#pagination'
+    $ref: ./Order.yaml
   return:
     $ref: ./AdminReturn.yaml

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

@@ -13,4 +13,4 @@ properties:
   unit_price:
     type: number
     title: unit_price
-    description: The order edit's unit price.
+    description: The item's unit price.

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

@@ -15,4 +15,4 @@ properties:
   unit_price:
     type: number
     title: unit_price
-    description: The order edit's unit price.
+    description: The item's unit price.

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

@@ -16,4 +16,4 @@ properties:
     description: The URL of the user's avatar.
   metadata:
     type: object
-    description: The user's metadata.
+    description: The user's metadata, can hold custom key-value pairs.

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

@@ -1,3 +1,33 @@
 type: object
 description: The image's details.
 x-schemaName: BaseProductImage
+properties:
+  id:
+    type: string
+    title: id
+    description: The image's ID.
+  url:
+    type: string
+    title: url
+    description: The image's URL.
+  created_at:
+    type: string
+    format: date-time
+    title: created_at
+    description: The date the image was created.
+  updated_at:
+    type: string
+    format: date-time
+    title: updated_at
+    description: The date the image was updated.
+  deleted_at:
+    type: string
+    format: date-time
+    title: deleted_at
+    description: The date the image was deleted.
+  metadata:
+    type: object
+    description: The image's metadata, can hold custom key-value pairs.
+required:
+  - id
+  - url

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

@@ -1,3 +1,44 @@
 type: object
 description: The product option's details.
 x-schemaName: BaseProductOption
+properties:
+  id:
+    type: string
+    title: id
+    description: The option's ID.
+  title:
+    type: string
+    title: title
+    description: The option's title.
+  product:
+    type: object
+  product_id:
+    type: string
+    title: product_id
+    description: The option's product id.
+  values:
+    type: array
+    description: The option's values.
+    items:
+      $ref: ./BaseProductOptionValue.yaml
+  metadata:
+    type: object
+    description: The option's metadata.
+  created_at:
+    type: string
+    format: date-time
+    title: created_at
+    description: The option's created at.
+  updated_at:
+    type: string
+    format: date-time
+    title: updated_at
+    description: The option's updated at.
+  deleted_at:
+    type: string
+    format: date-time
+    title: deleted_at
+    description: The option's deleted at.
+required:
+  - id
+  - title

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

@@ -1,3 +1,39 @@
 type: object
 description: The product option value's details.
 x-schemaName: BaseProductOptionValue
+required:
+  - id
+  - value
+properties:
+  id:
+    type: string
+    title: id
+    description: The value's ID.
+  value:
+    type: string
+    title: value
+    description: The value.
+  option:
+    type: object
+  option_id:
+    type: string
+    title: option_id
+    description: The ID of the option this value belongs to.
+  metadata:
+    type: object
+    description: The value's metadata, can hold custom key-value pairs.
+  created_at:
+    type: string
+    format: date-time
+    title: created_at
+    description: The date the value was created.
+  updated_at:
+    type: string
+    format: date-time
+    title: updated_at
+    description: The date the value was updated.
+  deleted_at:
+    type: string
+    format: date-time
+    title: deleted_at
+    description: The date the value was deleted.

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

@@ -5,8 +5,4 @@ required:
   - order
 properties:
   order:
-    type: string
-    title: order
-    description: The order's details.
-    externalDocs:
-      url: '#pagination'
+    $ref: ./StoreOrder.yaml