@scenario-labs/sdk 3.2.0 → 3.3.0

package/src/resources/workflows.ts

@@ -5,6 +5,7 @@ import { APIPromise } from '../core/api-promise';
 import { PagePromise, WorkflowsCursor, type WorkflowsCursorParams } from '../core/pagination';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
+import { omitUndefined } from '../internal/utils/values';
 
 export class Workflows extends APIResource {
   /**
@@ -12,7 +13,11 @@ export class Workflows extends APIResource {
    */
   create(params: WorkflowCreateParams, options?: RequestOptions): APIPromise<WorkflowCreateResponse> {
     const { projectId, ...body } = params;
-    return this._client.post('/workflows', { query: { projectId }, body, ...options });
+    return this._client.post('/workflows', {
+      body,
+      ...options,
+      query: { projectId, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -23,7 +28,10 @@ export class Workflows extends APIResource {
     query: WorkflowRetrieveParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<WorkflowRetrieveResponse> {
-    return this._client.get(path`/workflows/${workflowID}`, { query, ...options });
+    return this._client.get(path`/workflows/${workflowID}`, {
+      ...options,
+      query: { ...query, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -35,7 +43,11 @@ export class Workflows extends APIResource {
     options?: RequestOptions,
   ): APIPromise<WorkflowUpdateResponse> {
     const { projectId, ...body } = params;
-    return this._client.put(path`/workflows/${workflowID}`, { query: { projectId }, body, ...options });
+    return this._client.put(path`/workflows/${workflowID}`, {
+      body,
+      ...options,
+      query: { projectId, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -46,8 +58,8 @@ export class Workflows extends APIResource {
     options?: RequestOptions,
   ): PagePromise<WorkflowListResponsesWorkflowsCursor, WorkflowListResponse> {
     return this._client.getAPIList('/workflows', WorkflowsCursor<WorkflowListResponse>, {
-      query,
       ...options,
+      query: { ...query, ...omitUndefined(options?.query) },
     });
   }
 
@@ -60,7 +72,10 @@ export class Workflows extends APIResource {
     options?: RequestOptions,
   ): APIPromise<unknown> {
     const { projectId } = params ?? {};
-    return this._client.delete(path`/workflows/${workflowID}`, { query: { projectId }, ...options });
+    return this._client.delete(path`/workflows/${workflowID}`, {
+      ...options,
+      query: { projectId, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -71,7 +86,10 @@ export class Workflows extends APIResource {
     query: WorkflowGetTagsParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<WorkflowGetTagsResponse> {
-    return this._client.get('/workflows/tags', { query, ...options });
+    return this._client.get('/workflows/tags', {
+      ...options,
+      query: { ...query, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -84,9 +102,9 @@ export class Workflows extends APIResource {
   ): APIPromise<WorkflowRunResponse> {
     const { body, dryRun, projectId } = params;
     return this._client.put(path`/workflows/${workflowID}/run`, {
-      query: { dryRun, projectId },
       body: body,
       ...options,
+      query: { dryRun, projectId, ...omitUndefined(options?.query) },
     });
   }
 
@@ -103,9 +121,27 @@ export class Workflows extends APIResource {
   ): APIPromise<WorkflowUserApprovalResponse> {
     const { projectId, ...body } = params;
     return this._client.put(path`/workflows/${workflowID}/user-approval`, {
-      query: { projectId },
       body,
       ...options,
+      query: { projectId, ...omitUndefined(options?.query) },
+    });
+  }
+
+  /**
+   * Respond to a user-selection node in a workflow. Pass action="select" with
+   * selectedIndices to pick items and resume the workflow, or action="reject" to
+   * mark the node Rejected and cancel the workflow.
+   */
+  userSelection(
+    workflowID: string,
+    params: WorkflowUserSelectionParams,
+    options?: RequestOptions,
+  ): APIPromise<WorkflowUserSelectionResponse> {
+    const { projectId, ...body } = params;
+    return this._client.put(path`/workflows/${workflowID}/user-selection`, {
+      body,
+      ...options,
+      query: { projectId, ...omitUndefined(options?.query) },
     });
   }
 
@@ -280,6 +316,7 @@ export namespace WorkflowCreateResponse {
         | 'remove-background'
         | 'transform'
         | 'user-approval'
+        | 'user-selection'
         | 'workflow';
 
       /**
@@ -305,14 +342,15 @@ export namespace WorkflowCreateResponse {
       includeOutputsInWorkflowJob?: true;
 
       /**
-       * The inputs of the node.
+       * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+       * bound how many items the user may pick (defaults: 1 and 100); conditional
+       * connections may be present as additional inputs.
        */
       inputs?: Array<Flow.Input>;
 
       /**
-       * Statically-configured items for a List node. The node outputs this array as-is
-       * when executed. Only available for List nodes. The values can be strings,
-       * numbers, or asset IDs.
+       * Statically-configured items for a List node, or the frozen candidate list of a
+       * UserSelection node. The values can be strings, numbers, or asset IDs.
        */
       items?: Array<string>;
 
@@ -574,8 +612,7 @@ export namespace WorkflowCreateResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -805,8 +842,7 @@ export namespace WorkflowCreateResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -863,8 +899,7 @@ export namespace WorkflowCreateResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -875,12 +910,9 @@ export namespace WorkflowCreateResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -898,6 +930,26 @@ export namespace WorkflowCreateResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -938,8 +990,7 @@ export namespace WorkflowCreateResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -950,12 +1001,9 @@ export namespace WorkflowCreateResponse {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -973,6 +1021,26 @@ export namespace WorkflowCreateResponse {
            */
           ifNotDefined?: unknown;
         }
+
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
       }
 
       /**
@@ -1212,8 +1280,7 @@ export namespace WorkflowCreateResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -1233,8 +1300,7 @@ export namespace WorkflowCreateResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -1245,12 +1311,9 @@ export namespace WorkflowCreateResponse {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -1268,6 +1331,26 @@ export namespace WorkflowCreateResponse {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -1615,6 +1698,7 @@ export namespace WorkflowRetrieveResponse {
         | 'remove-background'
         | 'transform'
         | 'user-approval'
+        | 'user-selection'
         | 'workflow';
 
       /**
@@ -1640,14 +1724,15 @@ export namespace WorkflowRetrieveResponse {
       includeOutputsInWorkflowJob?: true;
 
       /**
-       * The inputs of the node.
+       * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+       * bound how many items the user may pick (defaults: 1 and 100); conditional
+       * connections may be present as additional inputs.
        */
       inputs?: Array<Flow.Input>;
 
       /**
-       * Statically-configured items for a List node. The node outputs this array as-is
-       * when executed. Only available for List nodes. The values can be strings,
-       * numbers, or asset IDs.
+       * Statically-configured items for a List node, or the frozen candidate list of a
+       * UserSelection node. The values can be strings, numbers, or asset IDs.
        */
       items?: Array<string>;
 
@@ -1909,8 +1994,7 @@ export namespace WorkflowRetrieveResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -2140,8 +2224,7 @@ export namespace WorkflowRetrieveResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -2198,8 +2281,7 @@ export namespace WorkflowRetrieveResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -2210,12 +2292,9 @@ export namespace WorkflowRetrieveResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -2233,6 +2312,26 @@ export namespace WorkflowRetrieveResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -2273,8 +2372,7 @@ export namespace WorkflowRetrieveResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -2285,12 +2383,9 @@ export namespace WorkflowRetrieveResponse {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -2308,6 +2403,26 @@ export namespace WorkflowRetrieveResponse {
            */
           ifNotDefined?: unknown;
         }
+
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
       }
 
       /**
@@ -2547,8 +2662,7 @@ export namespace WorkflowRetrieveResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -2568,8 +2682,7 @@ export namespace WorkflowRetrieveResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -2580,12 +2693,9 @@ export namespace WorkflowRetrieveResponse {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -2603,6 +2713,26 @@ export namespace WorkflowRetrieveResponse {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -2950,6 +3080,7 @@ export namespace WorkflowUpdateResponse {
         | 'remove-background'
         | 'transform'
         | 'user-approval'
+        | 'user-selection'
         | 'workflow';
 
       /**
@@ -2975,14 +3106,15 @@ export namespace WorkflowUpdateResponse {
       includeOutputsInWorkflowJob?: true;
 
       /**
-       * The inputs of the node.
+       * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+       * bound how many items the user may pick (defaults: 1 and 100); conditional
+       * connections may be present as additional inputs.
        */
       inputs?: Array<Flow.Input>;
 
       /**
-       * Statically-configured items for a List node. The node outputs this array as-is
-       * when executed. Only available for List nodes. The values can be strings,
-       * numbers, or asset IDs.
+       * Statically-configured items for a List node, or the frozen candidate list of a
+       * UserSelection node. The values can be strings, numbers, or asset IDs.
        */
       items?: Array<string>;
 
@@ -3244,8 +3376,7 @@ export namespace WorkflowUpdateResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -3475,8 +3606,7 @@ export namespace WorkflowUpdateResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -3533,8 +3663,7 @@ export namespace WorkflowUpdateResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -3545,12 +3674,9 @@ export namespace WorkflowUpdateResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -3568,6 +3694,26 @@ export namespace WorkflowUpdateResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -3608,8 +3754,7 @@ export namespace WorkflowUpdateResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -3620,12 +3765,9 @@ export namespace WorkflowUpdateResponse {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -3643,6 +3785,26 @@ export namespace WorkflowUpdateResponse {
            */
           ifNotDefined?: unknown;
         }
+
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
       }
 
       /**
@@ -3882,8 +4044,7 @@ export namespace WorkflowUpdateResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -3903,8 +4064,7 @@ export namespace WorkflowUpdateResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -3915,12 +4075,9 @@ export namespace WorkflowUpdateResponse {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -3938,6 +4095,26 @@ export namespace WorkflowUpdateResponse {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -4476,8 +4653,7 @@ export namespace WorkflowListResponse {
      * - \`ifNotDefined\`: Input is required when another specified input is not
      *   defined
      * - \`ifDefined\`: Input is required when another specified input is defined
-     * - \`conditionalValues\`: Input is required when another input has a specific
-     *   value
+     * - \`conditional\`: Input is required when other inputs have specific values
      *
      * By default, the input is not required.
      */
@@ -4497,8 +4673,7 @@ export namespace WorkflowListResponse {
      * - \`ifNotDefined\`: Input is required when another specified input is not
      *   defined
      * - \`ifDefined\`: Input is required when another specified input is defined
-     * - \`conditionalValues\`: Input is required when another input has a specific
-     *   value
+     * - \`conditional\`: Input is required when other inputs have specific values
      *
      * By default, the input is not required.
      */
@@ -4509,12 +4684,9 @@ export namespace WorkflowListResponse {
       always?: boolean;
 
       /**
-       * Makes this input required when another input has a specific value:
-       *
-       * - Key: name of the input to check
-       * - Value: operation and allowed values that trigger the requirement
+       * Makes this input required when other inputs have one of the listed values
        */
-      conditionalValues?: unknown;
+      conditional?: Required.Conditional;
 
       /**
        * Makes this input required when another input is defined:
@@ -4532,6 +4704,26 @@ export namespace WorkflowListResponse {
        */
       ifNotDefined?: unknown;
     }
+
+    export namespace Required {
+      /**
+       * Makes this input required when other inputs have one of the listed values
+       */
+      export interface Conditional {
+        /**
+         * The conditions to check:
+         *
+         * - Key: name of the input to check
+         * - Value: values of that input that satisfy the condition
+         */
+        values: unknown;
+
+        /**
+         * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+         */
+        operator?: 'and' | 'or';
+      }
+    }
   }
 
   /**
@@ -4585,6 +4777,7 @@ export namespace WorkflowListResponse {
       | 'remove-background'
       | 'transform'
       | 'user-approval'
+      | 'user-selection'
       | 'workflow';
 
     /**
@@ -4610,14 +4803,15 @@ export namespace WorkflowListResponse {
     includeOutputsInWorkflowJob?: true;
 
     /**
-     * The inputs of the node.
+     * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+     * bound how many items the user may pick (defaults: 1 and 100); conditional
+     * connections may be present as additional inputs.
      */
     inputs?: Array<Flow.Input>;
 
     /**
-     * Statically-configured items for a List node. The node outputs this array as-is
-     * when executed. Only available for List nodes. The values can be strings,
-     * numbers, or asset IDs.
+     * Statically-configured items for a List node, or the frozen candidate list of a
+     * UserSelection node. The values can be strings, numbers, or asset IDs.
      */
     items?: Array<string>;
 
@@ -4879,8 +5073,7 @@ export namespace WorkflowListResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -5110,8 +5303,7 @@ export namespace WorkflowListResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -5168,8 +5360,7 @@ export namespace WorkflowListResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -5180,12 +5371,9 @@ export namespace WorkflowListResponse {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -5203,6 +5391,26 @@ export namespace WorkflowListResponse {
            */
           ifNotDefined?: unknown;
         }
+
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
       }
 
       /**
@@ -5243,8 +5451,7 @@ export namespace WorkflowListResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -5255,12 +5462,9 @@ export namespace WorkflowListResponse {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -5278,6 +5482,26 @@ export namespace WorkflowListResponse {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -5663,6 +5887,7 @@ export namespace WorkflowRunResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -5693,14 +5918,15 @@ export namespace WorkflowRunResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -5980,8 +6206,7 @@ export namespace WorkflowRunResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -6211,8 +6436,7 @@ export namespace WorkflowRunResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -6269,8 +6493,7 @@ export namespace WorkflowRunResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -6281,12 +6504,9 @@ export namespace WorkflowRunResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -6304,6 +6524,26 @@ export namespace WorkflowRunResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -6344,8 +6584,7 @@ export namespace WorkflowRunResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -6356,12 +6595,9 @@ export namespace WorkflowRunResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -6379,6 +6615,26 @@ export namespace WorkflowRunResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -6649,6 +6905,7 @@ export namespace WorkflowRunResponse {
         | 'remove-background'
         | 'transform'
         | 'user-approval'
+        | 'user-selection'
         | 'workflow';
 
       /**
@@ -6674,14 +6931,15 @@ export namespace WorkflowRunResponse {
       includeOutputsInWorkflowJob?: true;
 
       /**
-       * The inputs of the node.
+       * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+       * bound how many items the user may pick (defaults: 1 and 100); conditional
+       * connections may be present as additional inputs.
        */
       inputs?: Array<Flow.Input>;
 
       /**
-       * Statically-configured items for a List node. The node outputs this array as-is
-       * when executed. Only available for List nodes. The values can be strings,
-       * numbers, or asset IDs.
+       * Statically-configured items for a List node, or the frozen candidate list of a
+       * UserSelection node. The values can be strings, numbers, or asset IDs.
        */
       items?: Array<string>;
 
@@ -6943,8 +7201,7 @@ export namespace WorkflowRunResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -7174,8 +7431,7 @@ export namespace WorkflowRunResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -7232,8 +7488,7 @@ export namespace WorkflowRunResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -7244,12 +7499,9 @@ export namespace WorkflowRunResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -7267,6 +7519,26 @@ export namespace WorkflowRunResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -7307,8 +7579,7 @@ export namespace WorkflowRunResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -7319,12 +7590,9 @@ export namespace WorkflowRunResponse {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -7342,6 +7610,26 @@ export namespace WorkflowRunResponse {
            */
           ifNotDefined?: unknown;
         }
+
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
       }
 
       /**
@@ -7581,8 +7869,7 @@ export namespace WorkflowRunResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -7602,8 +7889,7 @@ export namespace WorkflowRunResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -7614,12 +7900,9 @@ export namespace WorkflowRunResponse {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -7637,6 +7920,26 @@ export namespace WorkflowRunResponse {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -8010,6 +8313,7 @@ export namespace WorkflowUserApprovalResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -8040,14 +8344,15 @@ export namespace WorkflowUserApprovalResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -8327,8 +8632,7 @@ export namespace WorkflowUserApprovalResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -8558,8 +8862,7 @@ export namespace WorkflowUserApprovalResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -8616,8 +8919,7 @@ export namespace WorkflowUserApprovalResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -8628,12 +8930,9 @@ export namespace WorkflowUserApprovalResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -8651,10 +8950,1080 @@ export namespace WorkflowUserApprovalResponse {
                */
               ifNotDefined?: unknown;
             }
-          }
 
-          /**
-           * The reference to another input or output of the same workflow. Must have at
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
+          }
+
+          /**
+           * The reference to another input or output of the same workflow. Must have at
+           * least one of node or conditional.
+           */
+          export interface Ref {
+            /**
+             * The conditional nodes to reference. If the conditional nodes are successful, the
+             * node will be successful. If the conditional nodes are skipped, the node will be
+             * skipped. Contains an array of node ids used to check the status of the nodes.
+             */
+            conditional?: Array<string>;
+
+            /**
+             * This is the desired node output value if ref is an if/else node.
+             */
+            equal?: string;
+
+            /**
+             * The name of the input or output to reference. If the type is 'workflow', the
+             * name is the name of the input of the workflow is required If the type is 'node',
+             * the name is not mandatory, except if you want all outputs of the node. To get
+             * all outputs of a node, you can use the name 'all'.
+             */
+            name?: string;
+
+            /**
+             * The node id or 'workflow' if the source is a workflow input.
+             */
+            node?: string;
+          }
+
+          /**
+           * Set of rules that describes when this input is required:
+           *
+           * - \`always\`: Input is always required
+           * - \`ifNotDefined\`: Input is required when another specified input is not
+           *   defined
+           * - \`ifDefined\`: Input is required when another specified input is defined
+           * - \`conditional\`: Input is required when other inputs have specific values
+           *
+           * By default, the input is not required.
+           */
+          export interface Required {
+            /**
+             * Whether the input is always required
+             */
+            always?: boolean;
+
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            conditional?: Required.Conditional;
+
+            /**
+             * Makes this input required when another input is defined:
+             *
+             * - Key: name of the input that must be defined
+             * - Value: message to display when this input is required
+             */
+            ifDefined?: unknown;
+
+            /**
+             * Makes this input required when another input is not defined:
+             *
+             * - Key: name of the input that must be undefined
+             * - Value: message to display when this input is required
+             */
+            ifNotDefined?: unknown;
+          }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
+        }
+
+        /**
+         * The logic of the node. Only available for logic nodes.
+         */
+        export interface Logic {
+          /**
+           * The cases of the logic. Only available for if/else nodes.
+           */
+          cases?: Array<Logic.Case>;
+
+          /**
+           * The default case of the logic. Contains the id/output of the node to execute if
+           * no case is matched. Only available for if/else nodes.
+           */
+          default?: string;
+
+          /**
+           * The transform of the logic. Only available for transform nodes.
+           */
+          transform?: string;
+        }
+
+        export namespace Logic {
+          export interface Case {
+            condition: string;
+
+            value: string;
+          }
+        }
+      }
+    }
+
+    export interface StatusHistory {
+      date: string;
+
+      status:
+        | 'canceled'
+        | 'failure'
+        | 'finalizing'
+        | 'in-progress'
+        | 'pending'
+        | 'queued'
+        | 'success'
+        | 'warming-up';
+    }
+
+    /**
+     * The billing of the job
+     */
+    export interface Billing {
+      cuCost: number;
+
+      cuDiscount: number;
+
+      /**
+       * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
+       * top of the generation itself, such as `quality-gate`.
+       *
+       * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+       * values here.
+       *
+       * Two caveats when displaying it:
+       *
+       * - These are a remaining refundable balance, not a receipt: a job that failed or
+       *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+       *   still shows the main action's original charge.
+       * - `ip-detection` is part of the shape but is never populated today: that fee is
+       *   charged outside the job and reported once, as
+       *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+       *   it.
+       *
+       * Absent when the job paid for no add-on.
+       */
+      cuCostDetails?: Billing.CuCostDetails;
+
+      /**
+       * When true, the credits charged for this job are not automatically refunded if
+       * the generation fails, because the model used does not support refund-on-failure.
+       * Absent or false means a failed generation is refunded as usual.
+       */
+      disableRefund?: boolean;
+    }
+
+    export namespace Billing {
+      /**
+       * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
+       * top of the generation itself, such as `quality-gate`.
+       *
+       * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+       * values here.
+       *
+       * Two caveats when displaying it:
+       *
+       * - These are a remaining refundable balance, not a receipt: a job that failed or
+       *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+       *   still shows the main action's original charge.
+       * - `ip-detection` is part of the shape but is never populated today: that fee is
+       *   charged outside the job and reported once, as
+       *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+       *   it.
+       *
+       * Absent when the job paid for no add-on.
+       */
+      export interface CuCostDetails {
+        'ip-detection'?: number;
+
+        'quality-gate'?: number;
+      }
+    }
+  }
+}
+
+export interface WorkflowUserSelectionResponse {
+  job: WorkflowUserSelectionResponse.Job;
+}
+
+export namespace WorkflowUserSelectionResponse {
+  export interface Job {
+    /**
+     * The job creation date as an ISO string (example: "2023-02-03T11:19:41.579Z")
+     */
+    createdAt: string;
+
+    /**
+     * The job ID (example: "job_ocZCnG1Df35XRL1QyCZSRxAG8")
+     */
+    jobId: string;
+
+    /**
+     * The type of job
+     */
+    jobType:
+      | 'assets-download'
+      | 'canvas-export'
+      | 'caption'
+      | 'caption-llava'
+      | 'custom'
+      | 'describe-style'
+      | 'detection'
+      | 'embed'
+      | 'flux'
+      | 'flux-model-training'
+      | 'generate-prompt'
+      | 'image-generation'
+      | 'image-prompt-editing'
+      | 'inference'
+      | 'mesh-preview-rendering'
+      | 'model-download'
+      | 'model-import'
+      | 'model-training'
+      | 'musubi-model-training'
+      | 'openai-image-generation'
+      | 'patch-image'
+      | 'pixelate'
+      | 'reframe'
+      | 'remove-background'
+      | 'repaint'
+      | 'restyle'
+      | 'segment'
+      | 'skybox-3d'
+      | 'skybox-base-360'
+      | 'skybox-hdri'
+      | 'skybox-upscale-360'
+      | 'splat'
+      | 'texture'
+      | 'translate'
+      | 'upload'
+      | 'upscale'
+      | 'upscale-skybox'
+      | 'upscale-texture'
+      | 'vectorize'
+      | 'workflow';
+
+    /**
+     * Metadata of the job with some additional information
+     */
+    metadata: Job.Metadata;
+
+    /**
+     * Progress of the job (between 0 and 1)
+     */
+    progress: number;
+
+    /**
+     * The current status of the job
+     */
+    status:
+      | 'canceled'
+      | 'failure'
+      | 'finalizing'
+      | 'in-progress'
+      | 'pending'
+      | 'queued'
+      | 'success'
+      | 'warming-up';
+
+    /**
+     * The history of the different statuses the job went through with the ISO string
+     * date of when the job reached each statuses.
+     */
+    statusHistory: Array<Job.StatusHistory>;
+
+    /**
+     * The job last update date as an ISO string (example: "2023-02-03T11:19:41.579Z")
+     */
+    updatedAt: string;
+
+    /**
+     * The author user ID (example: "dcf121faaa1a0a0bbbd9ca1b73d62aea")
+     */
+    authorId?: string;
+
+    /**
+     * The billing of the job
+     */
+    billing?: Job.Billing;
+
+    /**
+     * The owner ID (example: "team_U3Qmc8PCdWXwAQJ4Dvw4tV6D")
+     */
+    ownerId?: string;
+  }
+
+  export namespace Job {
+    /**
+     * Metadata of the job with some additional information
+     */
+    export interface Metadata {
+      /**
+       * List of produced assets for this job
+       */
+      assetIds?: Array<string>;
+
+      /**
+       * Eventual error for the job
+       */
+      error?: string | null;
+
+      /**
+       * The flow of the job. Only available for workflow jobs.
+       */
+      flow?: Array<Metadata.Flow>;
+
+      /**
+       * Actionable hint for the user explaining what went wrong and how to resolve it.
+       */
+      hint?: string;
+
+      /**
+       * The inputs for the job
+       */
+      input?: { [key: string]: unknown };
+
+      /**
+       * May contain the output of the job for specific custom models jobs. Only
+       * available for custom models which generate non-assets outputs. Example: LLM text
+       * results.
+       */
+      output?: { [key: string]: unknown };
+
+      /**
+       * For voice-clone jobs: the ID of the model being trained.
+       */
+      outputModelId?: string;
+
+      /**
+       * The workflow ID of the job if job is part of a workflow.
+       */
+      workflowId?: string;
+
+      /**
+       * The workflow job ID of the job if job is part of a workflow job.
+       */
+      workflowJobId?: string;
+    }
+
+    export namespace Metadata {
+      export interface Flow {
+        /**
+         * The id of the node.
+         */
+        id: string;
+
+        /**
+         * The status of the node. Only available for WorkflowJob nodes.
+         */
+        status: 'failure' | 'pending' | 'processing' | 'rejected' | 'skipped' | 'success';
+
+        /**
+         * The type of the job for the node.
+         */
+        type:
+          | 'custom-model'
+          | 'for-each'
+          | 'generate-prompt'
+          | 'list'
+          | 'logic'
+          | 'model'
+          | 'remove-background'
+          | 'transform'
+          | 'user-approval'
+          | 'user-selection'
+          | 'workflow';
+
+        /**
+         * List of produced assets for this node.
+         */
+        assets?: Array<Flow.Asset>;
+
+        /**
+         * Fixed number of iterations for a ForEach node. When set, the loop runs exactly
+         * `count` times regardless of array input. When not set, the loop iterates over
+         * the resolved array input. Only available for ForEach nodes.
+         */
+        count?: number;
+
+        /**
+         * The nodes that this node depends on. Only available for nodes that have
+         * dependencies. Mainly used for user approval nodes.
+         */
+        dependsOn?: Array<string>;
+
+        /**
+         * If true, the outputs of this node will be included in the workflow job's final
+         * output. Only applicable to producing nodes (custom-model, inference, etc.). By
+         * default, only last nodes (nodes not referenced by other nodes) contribute to
+         * outputs. Set this to true to also include intermediate nodes in the final
+         * output. Note: This should only be set to `true` or left undefined.
+         */
+        includeOutputsInWorkflowJob?: true;
+
+        /**
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
+         */
+        inputs?: Array<Flow.Input>;
+
+        /**
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
+         */
+        items?: Array<string>;
+
+        /**
+         * Zero-based index of the iteration this node copy belongs to. Set on
+         * dynamically-created copies of loop body nodes.
+         */
+        iterationIndex?: number;
+
+        /**
+         * If the flow is part of a WorkflowJob, this is the jobId for the node. jobId is
+         * only available for nodes started. A node "Pending" for a running workflow job is
+         * not started.
+         */
+        jobId?: string;
+
+        /**
+         * The logic of the node. Only available for logic nodes.
+         */
+        logic?: Flow.Logic;
+
+        /**
+         * The type of the logic for the node. Only available for logic nodes.
+         */
+        logicType?: 'if-else';
+
+        /**
+         * IDs of the body template nodes that belong to this ForEach loop. At runtime
+         * these templates are cloned once per iteration and marked Skipped. Only available
+         * for ForEach nodes.
+         */
+        loopBodyNodeIds?: Array<string>;
+
+        /**
+         * ID of the ForEach node that spawned this iteration copy. Set on
+         * dynamically-created copies of loop body nodes.
+         */
+        loopNodeId?: string;
+
+        /**
+         * The model id for the node. Mainly used for custom model tasks.
+         */
+        modelId?: string;
+
+        /**
+         * The output of the node. Only available for logic nodes.
+         */
+        output?: unknown;
+
+        /**
+         * The workflow id for the node. Mainly used for workflow tasks.
+         */
+        workflowId?: string;
+      }
+
+      export namespace Flow {
+        export interface Asset {
+          assetId: string;
+
+          url: string;
+        }
+
+        /**
+         * This is used to run the flow.
+         */
+        export interface Input {
+          /**
+           * The name that must be user to call the model through the API
+           */
+          name: string;
+
+          /**
+           * The data type of the input
+           */
+          type:
+            | 'boolean'
+            | 'file'
+            | 'file_array'
+            | 'inputs_array'
+            | 'model'
+            | 'model_array'
+            | 'number'
+            | 'number_array'
+            | 'string'
+            | 'string_array';
+
+          /**
+           * The allowed values for the input. For \`string\` or \`number\` types, creates a
+           * single-select dropdown. For \`string_array\` type, creates a multi-select
+           * dropdown.
+           */
+          allowedValues?: Array<unknown>;
+
+          /**
+           * Specifies the background behavior for the input. Only available for \`file\` and
+           * \`file_array\` input types with kind \`image\`.
+           */
+          backgroundBehavior?: 'opaque' | 'transparent';
+
+          /**
+           * Whether the input is a color or not. Only available for \`string\` input type.
+           */
+          color?: boolean;
+
+          /**
+           * Whether this input affects the model's cost calculation
+           */
+          costImpact?: boolean;
+
+          /**
+           * The default value for the input
+           */
+          default?: unknown;
+
+          /**
+           * Help text displayed in the UI to provide additional information about the input
+           */
+          description?: string;
+
+          /**
+           * Used to visually group inputs together in the UI. Inputs with the same group
+           * value appear consecutively in the UI.
+           */
+          group?: string;
+
+          /**
+           * Hint text displayed in the UI as a tooltip to guide the user
+           */
+          hint?: string;
+
+          /**
+           * The list of inputs which form an object within a container array. All inputs are
+           * the same as the current object. This is only available for type inputs_array
+           * inputs.
+           */
+          inputs?: Array<{ [key: string]: unknown }>;
+
+          /**
+           * The configured items for inputs_array type inputs. Each item is an array of
+           * SubNodeInput that need ref/value resolution. Only available for inputs_array
+           * type.
+           */
+          items?: Array<Array<Input.Item>>;
+
+          /**
+           * The asset kind of the input. Only taken into account for \`file\` and
+           * \`file_array\` input types. If model provides multiple kinds, the input will be
+           * not able to create the asset on the flight on API side with dataurl without
+           * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+           * a model does not declare one, \`image\` is returned, which is the kind used at
+           * generation time.
+           */
+          kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
+
+          /**
+           * The label displayed in the UI for this input
+           */
+          label?: string;
+
+          /**
+           * The name of the file input field to use as the mask source
+           */
+          maskFrom?: string;
+
+          /**
+           * The maximum allowed value. Only available for \`number\` and \`array\` input
+           * types.
+           */
+          max?: number;
+
+          /**
+           * The maximum allowed media duration in seconds. Only applies to \`file\` and
+           * \`file_array\` input types for video and audio assets. Validated against
+           * \`asset.properties.duration\` at job creation time.
+           */
+          maxDuration?: number;
+
+          /**
+           * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
+           */
+          maxLength?: number;
+
+          /**
+           * The maximum allowed file size in bytes. Only applies to \`file\` and
+           * \`file_array\` input types. Validated against \`asset.properties.size\` at job
+           * creation time.
+           */
+          maxSize?: number;
+
+          /**
+           * The minimum allowed value. Only available for \`number\` and array input types.
+           */
+          min?: number;
+
+          /**
+           * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
+           */
+          minLength?: number;
+
+          /**
+           * The allowed model types for this input. Example: \`["flux.1-lora"]\`. Only
+           * available for \`model_array\` input type.
+           */
+          modelTypes?: Array<
+            | 'custom'
+            | 'elevenlabs-voice'
+            | 'flux.1'
+            | 'flux.1-composition'
+            | 'flux.1-kontext-dev'
+            | 'flux.1-kontext-lora'
+            | 'flux.1-krea-dev'
+            | 'flux.1-krea-lora'
+            | 'flux.1-lora'
+            | 'flux.1-pro'
+            | 'flux.1.1-pro-ultra'
+            | 'flux.2-dev-edit-lora'
+            | 'flux.2-dev-lora'
+            | 'flux.2-klein-4b-edit-lora'
+            | 'flux.2-klein-4b-lora'
+            | 'flux.2-klein-9b-edit-lora'
+            | 'flux.2-klein-9b-lora'
+            | 'flux.2-klein-base-4b-edit-lora'
+            | 'flux.2-klein-base-4b-lora'
+            | 'flux.2-klein-base-9b-edit-lora'
+            | 'flux.2-klein-base-9b-lora'
+            | 'flux1.1-pro'
+            | 'gpt-image-1'
+            | 'qwen-image-2512-lora'
+            | 'qwen-image-edit-2509-lora'
+            | 'qwen-image-edit-2511-lora'
+            | 'qwen-image-edit-lora'
+            | 'qwen-image-lora'
+            | 'zimage-de-turbo-lora'
+            | 'zimage-lora'
+            | 'zimage-turbo-lora'
+          >;
+
+          /**
+           * Whether this input represents a parent asset to assign to the produced assets.
+           * Only available for \`file\` and \`file_array\` input types.
+           *
+           * For \`file_array\`, the parent asset is the first item in the array.
+           */
+          parent?: boolean;
+
+          /**
+           * Placeholder text for the input. Only available for 'string' input type.
+           */
+          placeholder?: string;
+
+          /**
+           * Whether the input is a prompt. When true, displays as a text area with prompt
+           * spark feature. Only available for \`string\` input type.
+           */
+          prompt?: boolean;
+
+          /**
+           * Whether the input is used with prompt spark. Only available for \`string\` input
+           * type.
+           */
+          promptSpark?: boolean;
+
+          /**
+           * The reference to another input or output of the same workflow. Must have at
+           * least one of node or conditional.
+           */
+          ref?: Input.Ref;
+
+          /**
+           * Set of rules that describes when this input is required:
+           *
+           * - \`always\`: Input is always required
+           * - \`ifNotDefined\`: Input is required when another specified input is not
+           *   defined
+           * - \`ifDefined\`: Input is required when another specified input is defined
+           * - \`conditional\`: Input is required when other inputs have specific values
+           *
+           * By default, the input is not required.
+           */
+          required?: Input.Required;
+
+          /**
+           * The step increment for numeric inputs. Only available for \`number\` input type.
+           */
+          step?: number;
+
+          /**
+           * The value of the input. This is the value of the input that will be used to run
+           * the node. Only available for flows managed by a WorkflowJob.
+           */
+          value?: unknown;
+        }
+
+        export namespace Input {
+          /**
+           * A sub-input within an inputs_array item. Same as NodeInput but without the
+           * recursive items field.
+           */
+          export interface Item {
+            /**
+             * The name that must be user to call the model through the API
+             */
+            name: string;
+
+            /**
+             * The data type of the input
+             */
+            type:
+              | 'boolean'
+              | 'file'
+              | 'file_array'
+              | 'inputs_array'
+              | 'model'
+              | 'model_array'
+              | 'number'
+              | 'number_array'
+              | 'string'
+              | 'string_array';
+
+            /**
+             * The allowed values for the input. For \`string\` or \`number\` types, creates a
+             * single-select dropdown. For \`string_array\` type, creates a multi-select
+             * dropdown.
+             */
+            allowedValues?: Array<unknown>;
+
+            /**
+             * Specifies the background behavior for the input. Only available for \`file\` and
+             * \`file_array\` input types with kind \`image\`.
+             */
+            backgroundBehavior?: 'opaque' | 'transparent';
+
+            /**
+             * Whether the input is a color or not. Only available for \`string\` input type.
+             */
+            color?: boolean;
+
+            /**
+             * Whether this input affects the model's cost calculation
+             */
+            costImpact?: boolean;
+
+            /**
+             * The default value for the input
+             */
+            default?: unknown;
+
+            /**
+             * Help text displayed in the UI to provide additional information about the input
+             */
+            description?: string;
+
+            /**
+             * Used to visually group inputs together in the UI. Inputs with the same group
+             * value appear consecutively in the UI.
+             */
+            group?: string;
+
+            /**
+             * Hint text displayed in the UI as a tooltip to guide the user
+             */
+            hint?: string;
+
+            /**
+             * The list of inputs which form an object within a container array. All inputs are
+             * the same as the current object. This is only available for type inputs_array
+             * inputs.
+             */
+            inputs?: Array<{ [key: string]: unknown }>;
+
+            /**
+             * The asset kind of the input. Only taken into account for \`file\` and
+             * \`file_array\` input types. If model provides multiple kinds, the input will be
+             * not able to create the asset on the flight on API side with dataurl without
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
+             */
+            kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
+
+            /**
+             * The label displayed in the UI for this input
+             */
+            label?: string;
+
+            /**
+             * The name of the file input field to use as the mask source
+             */
+            maskFrom?: string;
+
+            /**
+             * The maximum allowed value. Only available for \`number\` and \`array\` input
+             * types.
+             */
+            max?: number;
+
+            /**
+             * The maximum allowed media duration in seconds. Only applies to \`file\` and
+             * \`file_array\` input types for video and audio assets. Validated against
+             * \`asset.properties.duration\` at job creation time.
+             */
+            maxDuration?: number;
+
+            /**
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
+             */
+            maxLength?: number;
+
+            /**
+             * The maximum allowed file size in bytes. Only applies to \`file\` and
+             * \`file_array\` input types. Validated against \`asset.properties.size\` at job
+             * creation time.
+             */
+            maxSize?: number;
+
+            /**
+             * The minimum allowed value. Only available for \`number\` and array input types.
+             */
+            min?: number;
+
+            /**
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
+             */
+            minLength?: number;
+
+            /**
+             * The allowed model types for this input. Example: \`["flux.1-lora"]\`. Only
+             * available for \`model_array\` input type.
+             */
+            modelTypes?: Array<
+              | 'custom'
+              | 'elevenlabs-voice'
+              | 'flux.1'
+              | 'flux.1-composition'
+              | 'flux.1-kontext-dev'
+              | 'flux.1-kontext-lora'
+              | 'flux.1-krea-dev'
+              | 'flux.1-krea-lora'
+              | 'flux.1-lora'
+              | 'flux.1-pro'
+              | 'flux.1.1-pro-ultra'
+              | 'flux.2-dev-edit-lora'
+              | 'flux.2-dev-lora'
+              | 'flux.2-klein-4b-edit-lora'
+              | 'flux.2-klein-4b-lora'
+              | 'flux.2-klein-9b-edit-lora'
+              | 'flux.2-klein-9b-lora'
+              | 'flux.2-klein-base-4b-edit-lora'
+              | 'flux.2-klein-base-4b-lora'
+              | 'flux.2-klein-base-9b-edit-lora'
+              | 'flux.2-klein-base-9b-lora'
+              | 'flux1.1-pro'
+              | 'gpt-image-1'
+              | 'qwen-image-2512-lora'
+              | 'qwen-image-edit-2509-lora'
+              | 'qwen-image-edit-2511-lora'
+              | 'qwen-image-edit-lora'
+              | 'qwen-image-lora'
+              | 'zimage-de-turbo-lora'
+              | 'zimage-lora'
+              | 'zimage-turbo-lora'
+            >;
+
+            /**
+             * Whether this input represents a parent asset to assign to the produced assets.
+             * Only available for \`file\` and \`file_array\` input types.
+             *
+             * For \`file_array\`, the parent asset is the first item in the array.
+             */
+            parent?: boolean;
+
+            /**
+             * Placeholder text for the input. Only available for 'string' input type.
+             */
+            placeholder?: string;
+
+            /**
+             * Whether the input is a prompt. When true, displays as a text area with prompt
+             * spark feature. Only available for \`string\` input type.
+             */
+            prompt?: boolean;
+
+            /**
+             * Whether the input is used with prompt spark. Only available for \`string\` input
+             * type.
+             */
+            promptSpark?: boolean;
+
+            /**
+             * The reference to another input or output of the same workflow. Must have at
+             * least one of node or conditional.
+             */
+            ref?: Item.Ref;
+
+            /**
+             * Set of rules that describes when this input is required:
+             *
+             * - \`always\`: Input is always required
+             * - \`ifNotDefined\`: Input is required when another specified input is not
+             *   defined
+             * - \`ifDefined\`: Input is required when another specified input is defined
+             * - \`conditional\`: Input is required when other inputs have specific values
+             *
+             * By default, the input is not required.
+             */
+            required?: Item.Required;
+
+            /**
+             * The step increment for numeric inputs. Only available for \`number\` input type.
+             */
+            step?: number;
+
+            /**
+             * The value of the input. This is the value of the input that will be used to run
+             * the node. Only available for flows managed by a WorkflowJob.
+             */
+            value?: unknown;
+          }
+
+          export namespace Item {
+            /**
+             * The reference to another input or output of the same workflow. Must have at
+             * least one of node or conditional.
+             */
+            export interface Ref {
+              /**
+               * The conditional nodes to reference. If the conditional nodes are successful, the
+               * node will be successful. If the conditional nodes are skipped, the node will be
+               * skipped. Contains an array of node ids used to check the status of the nodes.
+               */
+              conditional?: Array<string>;
+
+              /**
+               * This is the desired node output value if ref is an if/else node.
+               */
+              equal?: string;
+
+              /**
+               * The name of the input or output to reference. If the type is 'workflow', the
+               * name is the name of the input of the workflow is required If the type is 'node',
+               * the name is not mandatory, except if you want all outputs of the node. To get
+               * all outputs of a node, you can use the name 'all'.
+               */
+              name?: string;
+
+              /**
+               * The node id or 'workflow' if the source is a workflow input.
+               */
+              node?: string;
+            }
+
+            /**
+             * Set of rules that describes when this input is required:
+             *
+             * - \`always\`: Input is always required
+             * - \`ifNotDefined\`: Input is required when another specified input is not
+             *   defined
+             * - \`ifDefined\`: Input is required when another specified input is defined
+             * - \`conditional\`: Input is required when other inputs have specific values
+             *
+             * By default, the input is not required.
+             */
+            export interface Required {
+              /**
+               * Whether the input is always required
+               */
+              always?: boolean;
+
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              conditional?: Required.Conditional;
+
+              /**
+               * Makes this input required when another input is defined:
+               *
+               * - Key: name of the input that must be defined
+               * - Value: message to display when this input is required
+               */
+              ifDefined?: unknown;
+
+              /**
+               * Makes this input required when another input is not defined:
+               *
+               * - Key: name of the input that must be undefined
+               * - Value: message to display when this input is required
+               */
+              ifNotDefined?: unknown;
+            }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
+          }
+
+          /**
+           * The reference to another input or output of the same workflow. Must have at
            * least one of node or conditional.
            */
           export interface Ref {
@@ -8691,8 +10060,7 @@ export namespace WorkflowUserApprovalResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -8703,12 +10071,9 @@ export namespace WorkflowUserApprovalResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -8726,6 +10091,26 @@ export namespace WorkflowUserApprovalResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -8975,6 +10360,7 @@ export namespace WorkflowUpdateParams {
       | 'remove-background'
       | 'transform'
       | 'user-approval'
+      | 'user-selection'
       | 'workflow';
 
     /**
@@ -9000,14 +10386,15 @@ export namespace WorkflowUpdateParams {
     includeOutputsInWorkflowJob?: true;
 
     /**
-     * The inputs of the node.
+     * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+     * bound how many items the user may pick (defaults: 1 and 100); conditional
+     * connections may be present as additional inputs.
      */
     inputs?: Array<Flow.Input>;
 
     /**
-     * Statically-configured items for a List node. The node outputs this array as-is
-     * when executed. Only available for List nodes. The values can be strings,
-     * numbers, or asset IDs.
+     * Statically-configured items for a List node, or the frozen candidate list of a
+     * UserSelection node. The values can be strings, numbers, or asset IDs.
      */
     items?: Array<string>;
 
@@ -9269,8 +10656,7 @@ export namespace WorkflowUpdateParams {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -9500,8 +10886,7 @@ export namespace WorkflowUpdateParams {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -9558,8 +10943,7 @@ export namespace WorkflowUpdateParams {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -9570,12 +10954,9 @@ export namespace WorkflowUpdateParams {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -9593,6 +10974,26 @@ export namespace WorkflowUpdateParams {
            */
           ifNotDefined?: unknown;
         }
+
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
       }
 
       /**
@@ -9633,8 +11034,7 @@ export namespace WorkflowUpdateParams {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -9645,12 +11045,9 @@ export namespace WorkflowUpdateParams {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -9668,6 +11065,26 @@ export namespace WorkflowUpdateParams {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -9907,8 +11324,7 @@ export namespace WorkflowUpdateParams {
      * - \`ifNotDefined\`: Input is required when another specified input is not
      *   defined
      * - \`ifDefined\`: Input is required when another specified input is defined
-     * - \`conditionalValues\`: Input is required when another input has a specific
-     *   value
+     * - \`conditional\`: Input is required when other inputs have specific values
      *
      * By default, the input is not required.
      */
@@ -9928,8 +11344,7 @@ export namespace WorkflowUpdateParams {
      * - \`ifNotDefined\`: Input is required when another specified input is not
      *   defined
      * - \`ifDefined\`: Input is required when another specified input is defined
-     * - \`conditionalValues\`: Input is required when another input has a specific
-     *   value
+     * - \`conditional\`: Input is required when other inputs have specific values
      *
      * By default, the input is not required.
      */
@@ -9940,12 +11355,9 @@ export namespace WorkflowUpdateParams {
       always?: boolean;
 
       /**
-       * Makes this input required when another input has a specific value:
-       *
-       * - Key: name of the input to check
-       * - Value: operation and allowed values that trigger the requirement
+       * Makes this input required when other inputs have one of the listed values
        */
-      conditionalValues?: unknown;
+      conditional?: Required.Conditional;
 
       /**
        * Makes this input required when another input is defined:
@@ -9963,6 +11375,26 @@ export namespace WorkflowUpdateParams {
        */
       ifNotDefined?: unknown;
     }
+
+    export namespace Required {
+      /**
+       * Makes this input required when other inputs have one of the listed values
+       */
+      export interface Conditional {
+        /**
+         * The conditions to check:
+         *
+         * - Key: name of the input to check
+         * - Value: values of that input that satisfy the condition
+         */
+        values: unknown;
+
+        /**
+         * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+         */
+        operator?: 'and' | 'or';
+      }
+    }
   }
 }
 
@@ -10082,6 +11514,38 @@ export interface WorkflowUserApprovalParams {
   action?: 'approve' | 'reject';
 }
 
+export interface WorkflowUserSelectionParams {
+  /**
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId: string;
+
+  /**
+   * Body param: Decision taken on the selection node. "select" persists the picked
+   * items and advances the workflow; "reject" marks it Rejected and cancels the
+   * workflow.
+   */
+  action: 'select' | 'reject';
+
+  /**
+   * Body param: The ID of the user selection node to act on in the workflow
+   */
+  nodeId: string;
+
+  /**
+   * Body param: The ID of the workflow job that contains the user selection node
+   */
+  workflowJobId: string;
+
+  /**
+   * Body param: Zero-based indices into the node's `items` (the candidate list
+   * frozen when the node started processing). Required when action is "select".
+   * Order is preserved in the node output.
+   */
+  selectedIndices?: Array<number>;
+}
+
 export interface WorkflowApproveUserParams {
   /**
    * Query param: The projectId used for ownership resource management. Either to
@@ -10118,6 +11582,7 @@ export declare namespace Workflows {
     type WorkflowGetTagsResponse as WorkflowGetTagsResponse,
     type WorkflowRunResponse as WorkflowRunResponse,
     type WorkflowUserApprovalResponse as WorkflowUserApprovalResponse,
+    type WorkflowUserSelectionResponse as WorkflowUserSelectionResponse,
     type WorkflowListResponsesWorkflowsCursor as WorkflowListResponsesWorkflowsCursor,
     type WorkflowCreateParams as WorkflowCreateParams,
     type WorkflowRetrieveParams as WorkflowRetrieveParams,
@@ -10127,6 +11592,7 @@ export declare namespace Workflows {
     type WorkflowGetTagsParams as WorkflowGetTagsParams,
     type WorkflowRunParams as WorkflowRunParams,
     type WorkflowUserApprovalParams as WorkflowUserApprovalParams,
+    type WorkflowUserSelectionParams as WorkflowUserSelectionParams,
     type WorkflowApproveUserParams as WorkflowApproveUserParams,
   };
 }