chore(docs): Updated API Reference (v2) (#9174)

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

@@ -1,5 +1,5 @@
 type: object
-description: SUMMARY
+description: The shipping method's details.
 x-schemaName: AdminPostOrderEditsShippingReqSchema
 required:
   - shipping_option_id
@@ -7,19 +7,19 @@ properties:
   shipping_option_id:
     type: string
     title: shipping_option_id
-    description: The order edit's shipping option id.
+    description: The ID of the associated shipping option.
   custom_amount:
     type: number
     title: custom_amount
-    description: The order edit's custom amount.
+    description: Set a custom price for the shipping method.
   description:
     type: string
     title: description
-    description: The order edit's description.
+    description: The shipping method's description.
   internal_note:
     type: string
     title: internal_note
-    description: The order edit's internal note.
+    description: A note viewed only by admin users.
   metadata:
     type: object
-    description: The order edit's metadata.
+    description: The shipping method's metadata, can hold custom key-value pairs.