docs: fix OAS generator + generate OAS (#11584)

www/apps/api-reference/specs/admin/paths/admin_draft-orders.yaml

@@ -1804,35 +1804,7 @@ get:
       content:
         application/json:
           schema:
-            allOf:
-              - type: object
-                description: The paginated list of draft orders.
-                required:
-                  - limit
-                  - offset
-                  - count
-                properties:
-                  limit:
-                    type: number
-                    title: limit
-                    description: The maximum number of items returned.
-                  offset:
-                    type: number
-                    title: offset
-                    description: >-
-                      The number of items skipped before retrieving the returned
-                      items.
-                  count:
-                    type: number
-                    title: count
-                    description: The total number of items.
-              - type: object
-                description: The paginated list of draft orders.
-                required:
-                  - draft_orders
-                properties:
-                  draft_orders:
-                    $ref: ../components/schemas/AdminOrder.yaml
+            $ref: ../components/schemas/AdminDraftOrderListResponse.yaml
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -1845,6 +1817,7 @@ get:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
+  x-workflow: getOrdersListWorkflow
 post:
   operationId: PostDraftOrders
   summary: Create Draft Order

www/apps/api-reference/specs/admin/paths/admin_draft-orders_{id}.yaml

@@ -12,6 +12,26 @@ get:
       required: true
       schema:
         type: string
+    - name: fields
+      in: query
+      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.
+      required: false
+      schema:
+        type: string
+        title: fields
+        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.
+        externalDocs:
+          url: '#select-fields-and-relations'
   security:
     - api_token: []
     - cookie_auth: []
@@ -42,3 +62,72 @@ get:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
+  x-workflow: getOrderDetailWorkflow
+post:
+  operationId: PostDraftOrdersId
+  summary: Update a Draft Order
+  description: Update a draft order's details.
+  x-authenticated: true
+  parameters:
+    - name: id
+      in: path
+      description: The draft order's ID.
+      required: true
+      schema:
+        type: string
+    - name: fields
+      in: query
+      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.
+      required: false
+      schema:
+        type: string
+        title: fields
+        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.
+        externalDocs:
+          url: '#select-fields-and-relations'
+  security:
+    - api_token: []
+    - cookie_auth: []
+    - jwt_token: []
+  requestBody:
+    content:
+      application/json:
+        schema:
+          $ref: ../components/schemas/AdminUpdateDraftOrder.yaml
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/admin_draft-orders_{id}/post.sh
+  tags:
+    - Draft Orders
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            $ref: ../components/schemas/AdminDraftOrderResponse.yaml
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml
+  x-workflow: updateOrderWorkflow