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

@@ -1,5 +1,5 @@
 type: object
-description: SUMMARY
+description: The reservation's details.
 x-schemaName: AdminCreateReservation
 required:
   - location_id
@@ -9,23 +9,23 @@ properties:
   line_item_id:
     type: string
     title: line_item_id
-    description: The reservation's line item id.
+    description: The ID of the line item this reservation is created for.
   location_id:
     type: string
     title: location_id
-    description: The reservation's location id.
+    description: The ID of the location the quantity is reserved from.
   inventory_item_id:
     type: string
     title: inventory_item_id
-    description: The reservation's inventory item id.
+    description: The ID of the inventory item associated with the line item's variant.
   quantity:
     type: number
     title: quantity
-    description: The reservation's quantity.
+    description: The reserved quantity.
   description:
     type: string
     title: description
     description: The reservation's description.
   metadata:
     type: object
-    description: The reservation's metadata.
+    description: The reservation's metadata, used to store custom key-value pairs.