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

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

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

@@ -2,13 +2,8 @@ type: object
 description: SUMMARY
 x-schemaName: AdminPostCancelReturnReqSchema
 required:
-  - return_id
   - internal_note
 properties:
-  return_id:
-    type: string
-    title: return_id
-    description: The return's return id.
   no_notification:
     type: boolean
     title: no_notification

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

@@ -25751,18 +25751,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.
@@ -41685,13 +41679,8 @@ components:
       description: SUMMARY
       x-schemaName: AdminPostCancelReturnReqSchema
       required:
-        - return_id
         - internal_note
       properties:
-        return_id:
-          type: string
-          title: return_id
-          description: The return's return id.
         no_notification:
           type: boolean
           title: no_notification

www/apps/api-reference/specs/admin/paths/admin_products_import.yaml

@@ -16,18 +16,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.

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

@@ -2,13 +2,8 @@ type: object
 description: SUMMARY
 x-schemaName: AdminPostCancelReturnReqSchema
 required:
-  - return_id
   - internal_note
 properties:
-  return_id:
-    type: string
-    title: return_id
-    description: The return's return id.
   no_notification:
     type: boolean
     title: no_notification

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

@@ -5600,13 +5600,8 @@ components:
       description: SUMMARY
       x-schemaName: AdminPostCancelReturnReqSchema
       required:
-        - return_id
         - internal_note
       properties:
-        return_id:
-          type: string
-          title: return_id
-          description: The return's return id.
         no_notification:
           type: boolean
           title: no_notification

www/utils/generated/oas-output/operations/admin/post_admin_products_import.ts

@@ -15,18 +15,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.

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

@@ -4,13 +4,8 @@
  * description: SUMMARY
  * x-schemaName: AdminPostCancelReturnReqSchema
  * required:
- *   - return_id
  *   - internal_note
  * properties:
- *   return_id:
- *     type: string
- *     title: return_id
- *     description: The return's return id.
  *   no_notification:
  *     type: boolean
  *     title: no_notification