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

@@ -1,5 +1,5 @@
 type: object
-description: The claim item's claim items.
+description: The claim item's details.
 x-schemaName: BaseClaimItem
 required:
   - id
@@ -17,22 +17,22 @@ properties:
   claim_id:
     type: string
     title: claim_id
-    description: The claim item's claim id.
+    description: The ID of the claim this item belongs to.
   order_id:
     type: string
     title: order_id
-    description: The claim item's order id.
+    description: The ID of the order this item belongs to.
   item_id:
     type: string
     title: item_id
-    description: The claim item's item id.
+    description: The ID of the item in the order.
   quantity:
     type: number
     title: quantity
-    description: The claim item's quantity.
+    description: The quantity claimed.
   reason:
     type: string
-    description: The claim item's reason.
+    description: The claim's reason.
     enum:
       - missing_item
       - wrong_item
@@ -40,17 +40,28 @@ properties:
       - other
   raw_quantity:
     type: object
-    description: The claim item's raw quantity.
+    description: The quantity claimed.
+    properties:
+      value:
+        oneOf:
+          - type: string
+            title: value
+            description: The raw quantity's value.
+          - type: number
+            title: value
+            description: The raw quantity's value.
+    required:
+      - value
   metadata:
     type: object
-    description: The claim item's metadata.
+    description: The item's metadata, can hold custom key-value pairs.
   created_at:
     type: string
     format: date-time
     title: created_at
-    description: The claim item's created at.
+    description: The date the claim was created.
   updated_at:
     type: string
     format: date-time
     title: updated_at
-    description: The claim item's updated at.
+    description: The date the claim was updated.