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

Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action

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

@@ -124,6 +124,7 @@ properties:
       - exchange
       - claim
       - edit
+      - return_request
   return_id:
     type: string
     title: return_id

www/apps/api-reference/specs/admin/openapi.full.yaml

@@ -12508,18 +12508,12 @@ paths:
             description: Comma-separated relations that should be expanded in the returned data.
         - name: fields
           in: query
-          description: |-
+          description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
-            Comma-separated fields that should be included in the returned data.
-             * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
-             * without prefix it will replace the entire default fields.
           required: false
           schema:
             type: string
             title: fields
-            description: |-
+            description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
-              Comma-separated fields that should be included in the returned data.
-               * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
-               * without prefix it will replace the entire default fields.
         - name: offset
           in: query
           description: The number of items to skip when retrieving a list.
@@ -12576,6 +12570,10 @@ paths:
         '500':
           $ref: '#/components/responses/500_error'
       x-workflow: requestOrderEditRequestWorkflow
+      requestBody:
+        content:
+          application/json:
+            schema: {}
   /admin/order-edits/{id}/shipping-method:
     post:
       operationId: PostOrderEditsIdShippingMethod
@@ -53671,6 +53669,7 @@ components:
             - exchange
             - claim
             - edit
+            - return_request
         return_id:
           type: string
           title: return_id

www/apps/api-reference/specs/admin/paths/admin_order-edits_{id}_request.yaml

@@ -22,18 +22,20 @@ post:
           data.
     - name: fields
       in: query
-      description: |-
+      description: >-
-        Comma-separated fields that should be included in the returned data.
+        Comma-separated fields that should be included in the returned data. if
-         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+        a field is prefixed with `+` it will be added to the default fields,
-         * without prefix it will replace the entire default fields.
+        using `-` will remove it from the default fields. without prefix it will
+        replace the entire default fields.
       required: false
       schema:
         type: string
         title: fields
-        description: |-
+        description: >-
           Comma-separated fields that should be included in the returned data.
-           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+          if a field is prefixed with `+` it will be added to the default
-           * without prefix it will replace the entire default fields.
+          fields, using `-` will remove it from the default fields. without
+          prefix it will replace the entire default fields.
     - name: offset
       in: query
       description: The number of items to skip when retrieving a list.
@@ -94,3 +96,7 @@ post:
     '500':
       $ref: ../components/responses/500_error.yaml
   x-workflow: requestOrderEditRequestWorkflow
+  requestBody:
+    content:
+      application/json:
+        schema: {}

www/apps/api-reference/specs/store/components/schemas/BaseOrderChange.yaml

@@ -124,6 +124,7 @@ properties:
       - exchange
       - claim
       - edit
+      - return_request
   return_id:
     type: string
     title: return_id

www/apps/api-reference/specs/store/openapi.full.yaml

@@ -20002,6 +20002,7 @@ components:
             - exchange
             - claim
             - edit
+            - return_request
         return_id:
           type: string
           title: return_id

www/utils/generated/oas-output/operations/admin/post_admin_order-edits_[id]_request.ts

@@ -21,18 +21,18 @@
  *       description: Comma-separated relations that should be expanded in the returned data.
  *   - name: fields
  *     in: query
- *     description: >-
+ *     description: Comma-separated fields that should be included in the returned
- *       Comma-separated fields that should be included in the returned data.
+ *       data. if a field is prefixed with `+` it will be added to the default
- *        * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+ *       fields, using `-` will remove it from the default fields. without prefix
- *        * without prefix it will replace the entire default fields.
+ *       it will replace the entire default fields.
  *     required: false
  *     schema:
  *       type: string
  *       title: fields
- *       description: >-
+ *       description: Comma-separated fields that should be included in the returned
- *         Comma-separated fields that should be included in the returned data.
+ *         data. if a field is prefixed with `+` it will be added to the default
- *          * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+ *         fields, using `-` will remove it from the default fields. without prefix
- *          * without prefix it will replace the entire default fields.
+ *         it will replace the entire default fields.
  *   - name: offset
  *     in: query
  *     description: The number of items to skip when retrieving a list.
@@ -93,6 +93,10 @@
  *   "500":
  *     $ref: "#/components/responses/500_error"
  * x-workflow: requestOrderEditRequestWorkflow
+ * requestBody:
+ *   content:
+ *     application/json:
+ *       schema: {}
  * 
 */
 

www/utils/generated/oas-output/schemas/BaseOrderChange.ts

@@ -126,6 +126,7 @@
  *       - exchange
  *       - claim
  *       - edit
+ *       - return_request
  *   return_id:
  *     type: string
  *     title: return_id