chore(docs): Updated API Reference (automated) (#13794)

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>
Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>

www/apps/api-reference/specs/admin/paths/admin_product-categories.yaml

@@ -717,6 +717,49 @@ post:
           documentation.
         externalDocs:
           url: '#select-fields-and-relations'
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+        externalDocs:
+          url: '#pagination'
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+        externalDocs:
+          url: '#pagination'
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+        externalDocs:
+          url: '#pagination'
+    - name: with_deleted
+      in: query
+      description: Whether to include deleted records in the result.
+      required: false
+      schema:
+        type: boolean
+        title: with_deleted
+        description: Whether to include deleted records in the result.
   security:
     - api_token: []
     - cookie_auth: []

www/apps/api-reference/specs/admin/paths/admin_product-categories_{id}.yaml

@@ -78,6 +78,49 @@ get:
           `*category_children` to retreieve the fields of all child categories,
           or select specific fields to make the response size smaller. For
           example, `fields=category_children.id,category_children.name`.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+        externalDocs:
+          url: '#pagination'
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+        externalDocs:
+          url: '#pagination'
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+        externalDocs:
+          url: '#pagination'
+    - name: with_deleted
+      in: query
+      description: Whether to include deleted records in the result.
+      required: false
+      schema:
+        type: boolean
+        title: with_deleted
+        description: Whether to include deleted records in the result.
   security:
     - api_token: []
     - cookie_auth: []
@@ -150,6 +193,49 @@ post:
           documentation.
         externalDocs:
           url: '#select-fields-and-relations'
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+        externalDocs:
+          url: '#pagination'
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+        externalDocs:
+          url: '#pagination'
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+        externalDocs:
+          url: '#pagination'
+    - name: with_deleted
+      in: query
+      description: Whether to include deleted records in the result.
+      required: false
+      schema:
+        type: boolean
+        title: with_deleted
+        description: Whether to include deleted records in the result.
   security:
     - api_token: []
     - cookie_auth: []

www/apps/api-reference/specs/admin/paths/admin_refund-reasons.yaml

@@ -214,6 +214,10 @@ post:
         schema:
           $ref: ../components/schemas/AdminCreateRefundReason.yaml
   x-codeSamples:
+    - lang: JavaScript
+      label: JS SDK
+      source:
+        $ref: ../code_samples/JavaScript/admin_refund-reasons/post.js
     - lang: Shell
       label: cURL
       source:

www/apps/api-reference/specs/admin/paths/admin_refund-reasons_{id}.yaml

@@ -35,6 +35,10 @@ get:
     - cookie_auth: []
     - jwt_token: []
   x-codeSamples:
+    - lang: JavaScript
+      label: JS SDK
+      source:
+        $ref: ../code_samples/JavaScript/admin_refund-reasons_{id}/get.js
     - lang: Shell
       label: cURL
       source:
@@ -100,6 +104,10 @@ post:
         schema:
           $ref: ../components/schemas/AdminUpdatePaymentRefundReason.yaml
   x-codeSamples:
+    - lang: JavaScript
+      label: JS SDK
+      source:
+        $ref: ../code_samples/JavaScript/admin_refund-reasons_{id}/post.js
     - lang: Shell
       label: cURL
       source:
@@ -144,6 +152,10 @@ delete:
     - cookie_auth: []
     - jwt_token: []
   x-codeSamples:
+    - lang: JavaScript
+      label: JS SDK
+      source:
+        $ref: ../code_samples/JavaScript/admin_refund-reasons_{id}/delete.js
     - lang: Shell
       label: cURL
       source:
@@ -156,26 +168,7 @@ delete:
       content:
         application/json:
           schema:
-            type: object
-            description: The deletion's details.
-            required:
-              - id
-              - object
-              - deleted
-            properties:
-              id:
-                type: string
-                title: id
-                description: The refund reason's ID.
-              object:
-                type: string
-                title: object
-                description: The name of the deleted object.
-                default: refund_reason
-              deleted:
-                type: boolean
-                title: deleted
-                description: Whether the refund reason was deleted.
+            $ref: ../components/schemas/AdminRefundReasonDeleteResponse.yaml
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':

www/apps/api-reference/specs/admin/paths/admin_shipping-options.yaml

@@ -707,7 +707,10 @@ post:
     content:
       application/json:
         schema:
-          $ref: ../components/schemas/AdminCreateShippingOption.yaml
+          oneOf:
+            - $ref: ../components/schemas/AdminCreateFlatRateShippingOption.yaml
+            - $ref: ../components/schemas/AdminCreateCalculatedShippingOption.yaml
+          description: The shipping option's details.
   x-codeSamples:
     - lang: JavaScript
       label: JS SDK