@scenario-labs/sdk 3.2.0 → 3.3.1

package/resources/workflows.d.ts

@@ -39,6 +39,12 @@ export declare class Workflows extends APIResource {
      * cascades to the surrounding loop.
      */
     userApproval(workflowID: string, params: WorkflowUserApprovalParams, options?: RequestOptions): APIPromise<WorkflowUserApprovalResponse>;
+    /**
+     * 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>;
     /**
      * @deprecated Use `userApproval()` instead
      */
@@ -171,7 +177,7 @@ export declare namespace WorkflowCreateResponse {
             /**
              * The type of the job for the node.
              */
-            type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'workflow';
+            type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'user-selection' | 'workflow';
             /**
              * 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
@@ -192,13 +198,14 @@ export declare 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>;
             /**
@@ -385,8 +392,7 @@ export declare 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.
                  */
@@ -547,8 +553,7 @@ export declare 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.
                      */
@@ -598,8 +603,7 @@ export declare 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.
                      */
@@ -609,12 +613,9 @@ export declare 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:
                          *
@@ -630,6 +631,24 @@ export declare namespace WorkflowCreateResponse {
                          */
                         ifNotDefined?: unknown;
                     }
+                    namespace Required {
+                        /**
+                         * Makes this input required when other inputs have one of the listed values
+                         */
+                        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
@@ -665,8 +684,7 @@ export declare 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.
                  */
@@ -676,12 +694,9 @@ export declare 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:
                      *
@@ -697,6 +712,24 @@ export declare namespace WorkflowCreateResponse {
                      */
                     ifNotDefined?: unknown;
                 }
+                namespace Required {
+                    /**
+                     * Makes this input required when other inputs have one of the listed values
+                     */
+                    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.
@@ -865,8 +898,7 @@ export declare 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.
              */
@@ -884,8 +916,7 @@ export declare 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.
              */
@@ -895,12 +926,9 @@ export declare 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:
                  *
@@ -916,6 +944,24 @@ export declare namespace WorkflowCreateResponse {
                  */
                 ifNotDefined?: unknown;
             }
+            namespace Required {
+                /**
+                 * Makes this input required when other inputs have one of the listed values
+                 */
+                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';
+                }
+            }
         }
         /**
          * A representation of an asset after being processed by the workflow
@@ -1200,7 +1246,7 @@ export declare namespace WorkflowRetrieveResponse {
             /**
              * The type of the job for the node.
              */
-            type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'workflow';
+            type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'user-selection' | 'workflow';
             /**
              * 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
@@ -1221,13 +1267,14 @@ export declare 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>;
             /**
@@ -1414,8 +1461,7 @@ export declare 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.
                  */
@@ -1576,8 +1622,7 @@ export declare 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.
                      */
@@ -1627,8 +1672,7 @@ export declare 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.
                      */
@@ -1638,12 +1682,9 @@ export declare 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:
                          *
@@ -1659,6 +1700,24 @@ export declare namespace WorkflowRetrieveResponse {
                          */
                         ifNotDefined?: unknown;
                     }
+                    namespace Required {
+                        /**
+                         * Makes this input required when other inputs have one of the listed values
+                         */
+                        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
@@ -1694,8 +1753,7 @@ export declare 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.
                  */
@@ -1705,12 +1763,9 @@ export declare 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:
                      *
@@ -1726,6 +1781,24 @@ export declare namespace WorkflowRetrieveResponse {
                      */
                     ifNotDefined?: unknown;
                 }
+                namespace Required {
+                    /**
+                     * Makes this input required when other inputs have one of the listed values
+                     */
+                    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.
@@ -1894,8 +1967,7 @@ export declare 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.
              */
@@ -1913,8 +1985,7 @@ export declare 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.
              */
@@ -1924,12 +1995,9 @@ export declare 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:
                  *
@@ -1945,6 +2013,24 @@ export declare namespace WorkflowRetrieveResponse {
                  */
                 ifNotDefined?: unknown;
             }
+            namespace Required {
+                /**
+                 * Makes this input required when other inputs have one of the listed values
+                 */
+                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';
+                }
+            }
         }
         /**
          * A representation of an asset after being processed by the workflow
@@ -2229,7 +2315,7 @@ export declare namespace WorkflowUpdateResponse {
             /**
              * The type of the job for the node.
              */
-            type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'workflow';
+            type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'user-selection' | 'workflow';
             /**
              * 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
@@ -2250,13 +2336,14 @@ export declare 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>;
             /**
@@ -2443,8 +2530,7 @@ export declare 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.
                  */
@@ -2605,8 +2691,7 @@ export declare 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.
                      */
@@ -2656,8 +2741,7 @@ export declare 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.
                      */
@@ -2667,12 +2751,9 @@ export declare 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:
                          *
@@ -2688,6 +2769,24 @@ export declare namespace WorkflowUpdateResponse {
                          */
                         ifNotDefined?: unknown;
                     }
+                    namespace Required {
+                        /**
+                         * Makes this input required when other inputs have one of the listed values
+                         */
+                        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
@@ -2723,8 +2822,7 @@ export declare 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.
                  */
@@ -2734,12 +2832,9 @@ export declare 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:
                      *
@@ -2755,6 +2850,24 @@ export declare namespace WorkflowUpdateResponse {
                      */
                     ifNotDefined?: unknown;
                 }
+                namespace Required {
+                    /**
+                     * Makes this input required when other inputs have one of the listed values
+                     */
+                    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.
@@ -2923,8 +3036,7 @@ export declare 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.
              */
@@ -2942,8 +3054,7 @@ export declare 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.
              */
@@ -2953,12 +3064,9 @@ export declare 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:
                  *
@@ -2974,6 +3082,24 @@ export declare namespace WorkflowUpdateResponse {
                  */
                 ifNotDefined?: unknown;
             }
+            namespace Required {
+                /**
+                 * Makes this input required when other inputs have one of the listed values
+                 */
+                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';
+                }
+            }
         }
         /**
          * A representation of an asset after being processed by the workflow
@@ -3396,8 +3522,7 @@ export declare 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.
          */
@@ -3415,8 +3540,7 @@ export declare 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.
          */
@@ -3426,12 +3550,9 @@ export declare 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:
              *
@@ -3447,6 +3568,24 @@ export declare namespace WorkflowListResponse {
              */
             ifNotDefined?: unknown;
         }
+        namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            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';
+            }
+        }
     }
     /**
      * A representation of an asset after being processed by the workflow
@@ -3484,7 +3623,7 @@ export declare namespace WorkflowListResponse {
         /**
          * The type of the job for the node.
          */
-        type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'workflow';
+        type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'user-selection' | 'workflow';
         /**
          * 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
@@ -3505,13 +3644,14 @@ export declare 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>;
         /**
@@ -3698,8 +3838,7 @@ export declare 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.
              */
@@ -3860,8 +3999,7 @@ export declare 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.
                  */
@@ -3911,8 +4049,7 @@ export declare 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.
                  */
@@ -3922,12 +4059,9 @@ export declare 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:
                      *
@@ -3943,6 +4077,24 @@ export declare namespace WorkflowListResponse {
                      */
                     ifNotDefined?: unknown;
                 }
+                namespace Required {
+                    /**
+                     * Makes this input required when other inputs have one of the listed values
+                     */
+                    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
@@ -3978,8 +4130,7 @@ export declare 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.
              */
@@ -3989,12 +4140,9 @@ export declare 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:
                  *
@@ -4010,6 +4158,24 @@ export declare namespace WorkflowListResponse {
                  */
                 ifNotDefined?: unknown;
             }
+            namespace Required {
+                /**
+                 * Makes this input required when other inputs have one of the listed values
+                 */
+                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.
@@ -4287,7 +4453,7 @@ export declare namespace WorkflowRunResponse {
                 /**
                  * The type of the job for the node.
                  */
-                type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'workflow';
+                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.
                  */
@@ -4312,13 +4478,14 @@ export declare 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>;
                 /**
@@ -4519,8 +4686,7 @@ export declare 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.
                      */
@@ -4681,8 +4847,7 @@ export declare 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.
                          */
@@ -4732,8 +4897,7 @@ export declare 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.
                          */
@@ -4743,12 +4907,9 @@ export declare 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:
                              *
@@ -4764,6 +4925,24 @@ export declare namespace WorkflowRunResponse {
                              */
                             ifNotDefined?: unknown;
                         }
+                        namespace Required {
+                            /**
+                             * Makes this input required when other inputs have one of the listed values
+                             */
+                            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
@@ -4799,8 +4978,7 @@ export declare 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.
                      */
@@ -4810,12 +4988,9 @@ export declare 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:
                          *
@@ -4831,6 +5006,24 @@ export declare namespace WorkflowRunResponse {
                          */
                         ifNotDefined?: unknown;
                     }
+                    namespace Required {
+                        /**
+                         * Makes this input required when other inputs have one of the listed values
+                         */
+                        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.
@@ -5043,7 +5236,7 @@ export declare namespace WorkflowRunResponse {
             /**
              * The type of the job for the node.
              */
-            type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'workflow';
+            type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'user-selection' | 'workflow';
             /**
              * 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
@@ -5064,13 +5257,14 @@ export declare 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>;
             /**
@@ -5257,8 +5451,7 @@ export declare 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.
                  */
@@ -5419,8 +5612,7 @@ export declare 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.
                      */
@@ -5470,8 +5662,7 @@ export declare 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.
                      */
@@ -5481,12 +5672,9 @@ export declare 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:
                          *
@@ -5502,6 +5690,24 @@ export declare namespace WorkflowRunResponse {
                          */
                         ifNotDefined?: unknown;
                     }
+                    namespace Required {
+                        /**
+                         * Makes this input required when other inputs have one of the listed values
+                         */
+                        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
@@ -5537,8 +5743,7 @@ export declare 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.
                  */
@@ -5548,12 +5753,9 @@ export declare 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:
                      *
@@ -5569,6 +5771,24 @@ export declare namespace WorkflowRunResponse {
                      */
                     ifNotDefined?: unknown;
                 }
+                namespace Required {
+                    /**
+                     * Makes this input required when other inputs have one of the listed values
+                     */
+                    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.
@@ -5737,8 +5957,7 @@ export declare 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.
              */
@@ -5756,8 +5975,7 @@ export declare 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.
              */
@@ -5767,12 +5985,9 @@ export declare 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:
                  *
@@ -5788,6 +6003,24 @@ export declare namespace WorkflowRunResponse {
                  */
                 ifNotDefined?: unknown;
             }
+            namespace Required {
+                /**
+                 * Makes this input required when other inputs have one of the listed values
+                 */
+                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';
+                }
+            }
         }
         /**
          * A representation of an asset after being processed by the workflow
@@ -6058,7 +6291,7 @@ export declare namespace WorkflowUserApprovalResponse {
                 /**
                  * The type of the job for the node.
                  */
-                type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'workflow';
+                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.
                  */
@@ -6083,13 +6316,14 @@ export declare 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>;
                 /**
@@ -6290,8 +6524,7 @@ export declare 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.
                      */
@@ -6452,8 +6685,7 @@ export declare 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.
                          */
@@ -6503,8 +6735,7 @@ export declare 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.
                          */
@@ -6514,12 +6745,9 @@ export declare 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:
                              *
@@ -6535,6 +6763,24 @@ export declare namespace WorkflowUserApprovalResponse {
                              */
                             ifNotDefined?: unknown;
                         }
+                        namespace Required {
+                            /**
+                             * Makes this input required when other inputs have one of the listed values
+                             */
+                            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
@@ -6570,8 +6816,7 @@ export declare 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.
                      */
@@ -6581,12 +6826,9 @@ export declare 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:
                          *
@@ -6602,6 +6844,24 @@ export declare namespace WorkflowUserApprovalResponse {
                          */
                         ifNotDefined?: unknown;
                     }
+                    namespace Required {
+                        /**
+                         * Makes this input required when other inputs have one of the listed values
+                         */
+                        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.
@@ -6693,48 +6953,822 @@ export declare namespace WorkflowUserApprovalResponse {
         }
     }
 }
-export interface WorkflowCreateParams {
-    /**
-     * Body param
-     */
-    description: string;
-    /**
-     * Body param
-     */
-    name: string;
-    /**
-     * Query param: The projectId used for ownership resource management. Either to
-     * assert ownership or to set the owner of the resource(s)
-     */
-    projectId?: string;
-}
-export interface WorkflowRetrieveParams {
-    /**
-     * The projectId used for ownership resource management. Either to assert ownership
-     * or to set the owner of the resource(s)
-     */
-    projectId?: string;
+export interface WorkflowUserSelectionResponse {
+    job: WorkflowUserSelectionResponse.Job;
 }
-export interface WorkflowUpdateParams {
-    /**
-     * 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: The after asset of the workflow. Set to null to unset the after
-     * asset.
-     */
-    after?: string;
-    /**
-     * Body param: The before asset of the workflow. Set to null to unset the before
-     * asset.
-     */
-    before?: string;
-    /**
-     * Body param: Set to true to bypass the lock and save a locked workflow without
-     * unlocking it first. Only the author or a project admin can use this.
-     */
+export declare namespace WorkflowUserSelectionResponse {
+    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;
+    }
+    namespace Job {
+        /**
+         * Metadata of the job with some additional information
+         */
+        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;
+        }
+        namespace Metadata {
+            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;
+            }
+            namespace Flow {
+                interface Asset {
+                    assetId: string;
+                    url: string;
+                }
+                /**
+                 * This is used to run the flow.
+                 */
+                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;
+                }
+                namespace Input {
+                    /**
+                     * A sub-input within an inputs_array item. Same as NodeInput but without the
+                     * recursive items field.
+                     */
+                    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;
+                    }
+                    namespace Item {
+                        /**
+                         * The reference to another input or output of the same workflow. Must have at
+                         * least one of node or conditional.
+                         */
+                        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.
+                         */
+                        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;
+                        }
+                        namespace Required {
+                            /**
+                             * Makes this input required when other inputs have one of the listed values
+                             */
+                            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.
+                     */
+                    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.
+                     */
+                    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;
+                    }
+                    namespace Required {
+                        /**
+                         * Makes this input required when other inputs have one of the listed values
+                         */
+                        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.
+                 */
+                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;
+                }
+                namespace Logic {
+                    interface Case {
+                        condition: string;
+                        value: string;
+                    }
+                }
+            }
+        }
+        interface StatusHistory {
+            date: string;
+            status: 'canceled' | 'failure' | 'finalizing' | 'in-progress' | 'pending' | 'queued' | 'success' | 'warming-up';
+        }
+        /**
+         * The billing of the job
+         */
+        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;
+        }
+        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.
+             */
+            interface CuCostDetails {
+                'ip-detection'?: number;
+                'quality-gate'?: number;
+            }
+        }
+    }
+}
+export interface WorkflowCreateParams {
+    /**
+     * Body param
+     */
+    description: string;
+    /**
+     * Body param
+     */
+    name: string;
+    /**
+     * Query param: The projectId used for ownership resource management. Either to
+     * assert ownership or to set the owner of the resource(s)
+     */
+    projectId?: string;
+}
+export interface WorkflowRetrieveParams {
+    /**
+     * The projectId used for ownership resource management. Either to assert ownership
+     * or to set the owner of the resource(s)
+     */
+    projectId?: string;
+}
+export interface WorkflowUpdateParams {
+    /**
+     * 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: The after asset of the workflow. Set to null to unset the after
+     * asset.
+     */
+    after?: string;
+    /**
+     * Body param: The before asset of the workflow. Set to null to unset the before
+     * asset.
+     */
+    before?: string;
+    /**
+     * Body param: Set to true to bypass the lock and save a locked workflow without
+     * unlocking it first. Only the author or a project admin can use this.
+     */
     bypassLock?: boolean;
     /**
      * Body param: The description of the workflow.
@@ -6800,7 +7834,7 @@ export declare namespace WorkflowUpdateParams {
         /**
          * The type of the job for the node.
          */
-        type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'workflow';
+        type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'user-selection' | 'workflow';
         /**
          * 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
@@ -6821,13 +7855,14 @@ export declare 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>;
         /**
@@ -7014,8 +8049,7 @@ export declare 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.
              */
@@ -7176,8 +8210,7 @@ export declare 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.
                  */
@@ -7227,8 +8260,7 @@ export declare 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.
                  */
@@ -7238,12 +8270,9 @@ export declare 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:
                      *
@@ -7259,6 +8288,24 @@ export declare namespace WorkflowUpdateParams {
                      */
                     ifNotDefined?: unknown;
                 }
+                namespace Required {
+                    /**
+                     * Makes this input required when other inputs have one of the listed values
+                     */
+                    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
@@ -7294,8 +8341,7 @@ export declare 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.
              */
@@ -7305,12 +8351,9 @@ export declare 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:
                  *
@@ -7326,6 +8369,24 @@ export declare namespace WorkflowUpdateParams {
                  */
                 ifNotDefined?: unknown;
             }
+            namespace Required {
+                /**
+                 * Makes this input required when other inputs have one of the listed values
+                 */
+                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.
@@ -7494,8 +8555,7 @@ export declare 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.
          */
@@ -7513,8 +8573,7 @@ export declare 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.
          */
@@ -7524,12 +8583,9 @@ export declare 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:
              *
@@ -7545,6 +8601,24 @@ export declare namespace WorkflowUpdateParams {
              */
             ifNotDefined?: unknown;
         }
+        namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            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';
+            }
+        }
     }
 }
 export interface WorkflowListParams extends WorkflowsCursorParams {
@@ -7646,6 +8720,33 @@ 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
@@ -7669,6 +8770,6 @@ export interface WorkflowApproveUserParams {
     action?: 'approve' | 'reject';
 }
 export declare namespace Workflows {
-    export { type WorkflowCreateResponse as WorkflowCreateResponse, type WorkflowRetrieveResponse as WorkflowRetrieveResponse, type WorkflowUpdateResponse as WorkflowUpdateResponse, type WorkflowListResponse as WorkflowListResponse, type WorkflowDeleteResponse as WorkflowDeleteResponse, type WorkflowGetTagsResponse as WorkflowGetTagsResponse, type WorkflowRunResponse as WorkflowRunResponse, type WorkflowUserApprovalResponse as WorkflowUserApprovalResponse, type WorkflowListResponsesWorkflowsCursor as WorkflowListResponsesWorkflowsCursor, type WorkflowCreateParams as WorkflowCreateParams, type WorkflowRetrieveParams as WorkflowRetrieveParams, type WorkflowUpdateParams as WorkflowUpdateParams, type WorkflowListParams as WorkflowListParams, type WorkflowDeleteParams as WorkflowDeleteParams, type WorkflowGetTagsParams as WorkflowGetTagsParams, type WorkflowRunParams as WorkflowRunParams, type WorkflowUserApprovalParams as WorkflowUserApprovalParams, type WorkflowApproveUserParams as WorkflowApproveUserParams, };
+    export { type WorkflowCreateResponse as WorkflowCreateResponse, type WorkflowRetrieveResponse as WorkflowRetrieveResponse, type WorkflowUpdateResponse as WorkflowUpdateResponse, type WorkflowListResponse as WorkflowListResponse, type WorkflowDeleteResponse as WorkflowDeleteResponse, 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, type WorkflowUpdateParams as WorkflowUpdateParams, type WorkflowListParams as WorkflowListParams, type WorkflowDeleteParams as WorkflowDeleteParams, type WorkflowGetTagsParams as WorkflowGetTagsParams, type WorkflowRunParams as WorkflowRunParams, type WorkflowUserApprovalParams as WorkflowUserApprovalParams, type WorkflowUserSelectionParams as WorkflowUserSelectionParams, type WorkflowApproveUserParams as WorkflowApproveUserParams, };
 }
 //# sourceMappingURL=workflows.d.ts.map