chore(docs): Refactor API Reference (#1883)

docs/api/admin/paths/draft-orders_{id}_line-items.yaml

@@ -0,0 +1,48 @@
+post:
+  operationId: PostDraftOrdersDraftOrderLineItems
+  summary: Create a Line Item for Draft Order
+  description: Creates a Line Item for the Draft Order
+  x-authenticated: true
+  parameters:
+    - in: path
+      name: id
+      required: true
+      description: The ID of the Draft Order.
+      schema:
+        type: string
+  requestBody:
+    content:
+      application/json:
+        schema:
+          required:
+            - quantity
+          properties:
+            variant_id:
+              description: The ID of the Product Variant to generate the Line Item from.
+              type: string
+            unit_price:
+              description: The potential custom price of the item.
+              type: integer
+            title:
+              description: The potential custom title of the item.
+              type: string
+              default: Custom item
+            quantity:
+              description: The quantity of the Line Item.
+              type: integer
+            metadata:
+              description: >-
+                The optional key-value map with additional details about the
+                Line Item.
+              type: object
+  tags:
+    - Draft Order
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            properties:
+              draft_order:
+                $ref: ../components/schemas/draft-order.yaml