@scenario-labs/sdk 3.1.0 → 3.3.0

package/src/resources/workflows.ts

@@ -5,6 +5,7 @@ import { APIPromise } from '../core/api-promise';
 import { PagePromise, WorkflowsCursor, type WorkflowsCursorParams } from '../core/pagination';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
+import { omitUndefined } from '../internal/utils/values';
 
 export class Workflows extends APIResource {
   /**
@@ -12,7 +13,11 @@ export class Workflows extends APIResource {
    */
   create(params: WorkflowCreateParams, options?: RequestOptions): APIPromise<WorkflowCreateResponse> {
     const { projectId, ...body } = params;
-    return this._client.post('/workflows', { query: { projectId }, body, ...options });
+    return this._client.post('/workflows', {
+      body,
+      ...options,
+      query: { projectId, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -23,7 +28,10 @@ export class Workflows extends APIResource {
     query: WorkflowRetrieveParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<WorkflowRetrieveResponse> {
-    return this._client.get(path`/workflows/${workflowID}`, { query, ...options });
+    return this._client.get(path`/workflows/${workflowID}`, {
+      ...options,
+      query: { ...query, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -35,7 +43,11 @@ export class Workflows extends APIResource {
     options?: RequestOptions,
   ): APIPromise<WorkflowUpdateResponse> {
     const { projectId, ...body } = params;
-    return this._client.put(path`/workflows/${workflowID}`, { query: { projectId }, body, ...options });
+    return this._client.put(path`/workflows/${workflowID}`, {
+      body,
+      ...options,
+      query: { projectId, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -46,8 +58,8 @@ export class Workflows extends APIResource {
     options?: RequestOptions,
   ): PagePromise<WorkflowListResponsesWorkflowsCursor, WorkflowListResponse> {
     return this._client.getAPIList('/workflows', WorkflowsCursor<WorkflowListResponse>, {
-      query,
       ...options,
+      query: { ...query, ...omitUndefined(options?.query) },
     });
   }
 
@@ -60,7 +72,10 @@ export class Workflows extends APIResource {
     options?: RequestOptions,
   ): APIPromise<unknown> {
     const { projectId } = params ?? {};
-    return this._client.delete(path`/workflows/${workflowID}`, { query: { projectId }, ...options });
+    return this._client.delete(path`/workflows/${workflowID}`, {
+      ...options,
+      query: { projectId, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -71,7 +86,10 @@ export class Workflows extends APIResource {
     query: WorkflowGetTagsParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<WorkflowGetTagsResponse> {
-    return this._client.get('/workflows/tags', { query, ...options });
+    return this._client.get('/workflows/tags', {
+      ...options,
+      query: { ...query, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -84,9 +102,9 @@ export class Workflows extends APIResource {
   ): APIPromise<WorkflowRunResponse> {
     const { body, dryRun, projectId } = params;
     return this._client.put(path`/workflows/${workflowID}/run`, {
-      query: { dryRun, projectId },
       body: body,
       ...options,
+      query: { dryRun, projectId, ...omitUndefined(options?.query) },
     });
   }
 
@@ -103,9 +121,27 @@ export class Workflows extends APIResource {
   ): APIPromise<WorkflowUserApprovalResponse> {
     const { projectId, ...body } = params;
     return this._client.put(path`/workflows/${workflowID}/user-approval`, {
-      query: { projectId },
       body,
       ...options,
+      query: { projectId, ...omitUndefined(options?.query) },
+    });
+  }
+
+  /**
+   * Respond to a user-selection node in a workflow. Pass action="select" with
+   * selectedIndices to pick items and resume the workflow, or action="reject" to
+   * mark the node Rejected and cancel the workflow.
+   */
+  userSelection(
+    workflowID: string,
+    params: WorkflowUserSelectionParams,
+    options?: RequestOptions,
+  ): APIPromise<WorkflowUserSelectionResponse> {
+    const { projectId, ...body } = params;
+    return this._client.put(path`/workflows/${workflowID}/user-selection`, {
+      body,
+      ...options,
+      query: { projectId, ...omitUndefined(options?.query) },
     });
   }
 
@@ -280,6 +316,7 @@ export namespace WorkflowCreateResponse {
         | 'remove-background'
         | 'transform'
         | 'user-approval'
+        | 'user-selection'
         | 'workflow';
 
       /**
@@ -305,14 +342,15 @@ export namespace WorkflowCreateResponse {
       includeOutputsInWorkflowJob?: true;
 
       /**
-       * The inputs of the node.
+       * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+       * bound how many items the user may pick (defaults: 1 and 100); conditional
+       * connections may be present as additional inputs.
        */
       inputs?: Array<Flow.Input>;
 
       /**
-       * Statically-configured items for a List node. The node outputs this array as-is
-       * when executed. Only available for List nodes. The values can be strings,
-       * numbers, or asset IDs.
+       * Statically-configured items for a List node, or the frozen candidate list of a
+       * UserSelection node. The values can be strings, numbers, or asset IDs.
        */
       items?: Array<string>;
 
@@ -443,7 +481,9 @@ export namespace WorkflowCreateResponse {
          * 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
+         * 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';
 
@@ -471,8 +511,9 @@ export namespace WorkflowCreateResponse {
         maxDuration?: number;
 
         /**
-         * The maximum allowed length for \`string\` inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -489,8 +530,9 @@ export namespace WorkflowCreateResponse {
         min?: number;
 
         /**
-         * The minimum allowed length for string inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -570,8 +612,7 @@ export namespace WorkflowCreateResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -670,7 +711,9 @@ export namespace WorkflowCreateResponse {
            * 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
+           * 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';
 
@@ -698,8 +741,9 @@ export namespace WorkflowCreateResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -716,8 +760,9 @@ export namespace WorkflowCreateResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -797,8 +842,7 @@ export namespace WorkflowCreateResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -855,8 +899,7 @@ export namespace WorkflowCreateResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -867,12 +910,9 @@ export namespace WorkflowCreateResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -890,6 +930,26 @@ export namespace WorkflowCreateResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -930,8 +990,7 @@ export namespace WorkflowCreateResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -942,12 +1001,9 @@ export namespace WorkflowCreateResponse {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -965,6 +1021,26 @@ export namespace WorkflowCreateResponse {
            */
           ifNotDefined?: unknown;
         }
+
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
       }
 
       /**
@@ -1079,7 +1155,9 @@ export namespace WorkflowCreateResponse {
        * 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
+       * 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';
 
@@ -1107,8 +1185,9 @@ export namespace WorkflowCreateResponse {
       maxDuration?: number;
 
       /**
-       * The maximum allowed length for \`string\` inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -1125,8 +1204,9 @@ export namespace WorkflowCreateResponse {
       min?: number;
 
       /**
-       * The minimum allowed length for string inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -1200,8 +1280,7 @@ export namespace WorkflowCreateResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -1221,8 +1300,7 @@ export namespace WorkflowCreateResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -1233,12 +1311,9 @@ export namespace WorkflowCreateResponse {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -1256,6 +1331,26 @@ export namespace WorkflowCreateResponse {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -1313,6 +1408,11 @@ export namespace WorkflowCreateResponse {
        */
       lorasComponent?: UiConfig.LorasComponent;
 
+      /**
+       * Configuration for the provider outputs exposed by `exposeOutput`
+       */
+      outputProperties?: { [key: string]: UiConfig.OutputProperties };
+
       /**
        * Configuration for the presets
        */
@@ -1367,6 +1467,10 @@ export namespace WorkflowCreateResponse {
         modelIdInput?: string;
       }
 
+      export interface OutputProperties {
+        label: string;
+      }
+
       export interface Preset {
         fields: Array<string>;
 
@@ -1594,6 +1698,7 @@ export namespace WorkflowRetrieveResponse {
         | 'remove-background'
         | 'transform'
         | 'user-approval'
+        | 'user-selection'
         | 'workflow';
 
       /**
@@ -1619,14 +1724,15 @@ export namespace WorkflowRetrieveResponse {
       includeOutputsInWorkflowJob?: true;
 
       /**
-       * The inputs of the node.
+       * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+       * bound how many items the user may pick (defaults: 1 and 100); conditional
+       * connections may be present as additional inputs.
        */
       inputs?: Array<Flow.Input>;
 
       /**
-       * Statically-configured items for a List node. The node outputs this array as-is
-       * when executed. Only available for List nodes. The values can be strings,
-       * numbers, or asset IDs.
+       * Statically-configured items for a List node, or the frozen candidate list of a
+       * UserSelection node. The values can be strings, numbers, or asset IDs.
        */
       items?: Array<string>;
 
@@ -1757,7 +1863,9 @@ export namespace WorkflowRetrieveResponse {
          * 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
+         * 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';
 
@@ -1785,8 +1893,9 @@ export namespace WorkflowRetrieveResponse {
         maxDuration?: number;
 
         /**
-         * The maximum allowed length for \`string\` inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -1803,8 +1912,9 @@ export namespace WorkflowRetrieveResponse {
         min?: number;
 
         /**
-         * The minimum allowed length for string inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -1884,8 +1994,7 @@ export namespace WorkflowRetrieveResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -1984,7 +2093,9 @@ export namespace WorkflowRetrieveResponse {
            * 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
+           * 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';
 
@@ -2012,8 +2123,9 @@ export namespace WorkflowRetrieveResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -2030,8 +2142,9 @@ export namespace WorkflowRetrieveResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -2111,8 +2224,7 @@ export namespace WorkflowRetrieveResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -2169,8 +2281,7 @@ export namespace WorkflowRetrieveResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -2181,12 +2292,9 @@ export namespace WorkflowRetrieveResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -2204,6 +2312,26 @@ export namespace WorkflowRetrieveResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -2244,8 +2372,7 @@ export namespace WorkflowRetrieveResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -2256,12 +2383,9 @@ export namespace WorkflowRetrieveResponse {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -2279,6 +2403,26 @@ export namespace WorkflowRetrieveResponse {
            */
           ifNotDefined?: unknown;
         }
+
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
       }
 
       /**
@@ -2393,7 +2537,9 @@ export namespace WorkflowRetrieveResponse {
        * 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
+       * 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';
 
@@ -2421,8 +2567,9 @@ export namespace WorkflowRetrieveResponse {
       maxDuration?: number;
 
       /**
-       * The maximum allowed length for \`string\` inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -2439,8 +2586,9 @@ export namespace WorkflowRetrieveResponse {
       min?: number;
 
       /**
-       * The minimum allowed length for string inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -2514,8 +2662,7 @@ export namespace WorkflowRetrieveResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -2535,8 +2682,7 @@ export namespace WorkflowRetrieveResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -2547,12 +2693,9 @@ export namespace WorkflowRetrieveResponse {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -2570,6 +2713,26 @@ export namespace WorkflowRetrieveResponse {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -2627,6 +2790,11 @@ export namespace WorkflowRetrieveResponse {
        */
       lorasComponent?: UiConfig.LorasComponent;
 
+      /**
+       * Configuration for the provider outputs exposed by `exposeOutput`
+       */
+      outputProperties?: { [key: string]: UiConfig.OutputProperties };
+
       /**
        * Configuration for the presets
        */
@@ -2681,6 +2849,10 @@ export namespace WorkflowRetrieveResponse {
         modelIdInput?: string;
       }
 
+      export interface OutputProperties {
+        label: string;
+      }
+
       export interface Preset {
         fields: Array<string>;
 
@@ -2908,6 +3080,7 @@ export namespace WorkflowUpdateResponse {
         | 'remove-background'
         | 'transform'
         | 'user-approval'
+        | 'user-selection'
         | 'workflow';
 
       /**
@@ -2933,14 +3106,15 @@ export namespace WorkflowUpdateResponse {
       includeOutputsInWorkflowJob?: true;
 
       /**
-       * The inputs of the node.
+       * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+       * bound how many items the user may pick (defaults: 1 and 100); conditional
+       * connections may be present as additional inputs.
        */
       inputs?: Array<Flow.Input>;
 
       /**
-       * Statically-configured items for a List node. The node outputs this array as-is
-       * when executed. Only available for List nodes. The values can be strings,
-       * numbers, or asset IDs.
+       * Statically-configured items for a List node, or the frozen candidate list of a
+       * UserSelection node. The values can be strings, numbers, or asset IDs.
        */
       items?: Array<string>;
 
@@ -3071,7 +3245,9 @@ export namespace WorkflowUpdateResponse {
          * 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
+         * 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';
 
@@ -3099,8 +3275,9 @@ export namespace WorkflowUpdateResponse {
         maxDuration?: number;
 
         /**
-         * The maximum allowed length for \`string\` inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -3117,8 +3294,9 @@ export namespace WorkflowUpdateResponse {
         min?: number;
 
         /**
-         * The minimum allowed length for string inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -3198,8 +3376,7 @@ export namespace WorkflowUpdateResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -3298,7 +3475,9 @@ export namespace WorkflowUpdateResponse {
            * 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
+           * 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';
 
@@ -3326,8 +3505,9 @@ export namespace WorkflowUpdateResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -3344,8 +3524,9 @@ export namespace WorkflowUpdateResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -3425,8 +3606,7 @@ export namespace WorkflowUpdateResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -3483,8 +3663,7 @@ export namespace WorkflowUpdateResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -3495,12 +3674,9 @@ export namespace WorkflowUpdateResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -3518,6 +3694,26 @@ export namespace WorkflowUpdateResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -3558,8 +3754,7 @@ export namespace WorkflowUpdateResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -3570,12 +3765,9 @@ export namespace WorkflowUpdateResponse {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -3593,6 +3785,26 @@ export namespace WorkflowUpdateResponse {
            */
           ifNotDefined?: unknown;
         }
+
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
       }
 
       /**
@@ -3707,7 +3919,9 @@ export namespace WorkflowUpdateResponse {
        * 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
+       * 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';
 
@@ -3735,8 +3949,9 @@ export namespace WorkflowUpdateResponse {
       maxDuration?: number;
 
       /**
-       * The maximum allowed length for \`string\` inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -3753,8 +3968,9 @@ export namespace WorkflowUpdateResponse {
       min?: number;
 
       /**
-       * The minimum allowed length for string inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -3828,8 +4044,7 @@ export namespace WorkflowUpdateResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -3849,8 +4064,7 @@ export namespace WorkflowUpdateResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -3861,12 +4075,9 @@ export namespace WorkflowUpdateResponse {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -3884,6 +4095,26 @@ export namespace WorkflowUpdateResponse {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -3941,6 +4172,11 @@ export namespace WorkflowUpdateResponse {
        */
       lorasComponent?: UiConfig.LorasComponent;
 
+      /**
+       * Configuration for the provider outputs exposed by `exposeOutput`
+       */
+      outputProperties?: { [key: string]: UiConfig.OutputProperties };
+
       /**
        * Configuration for the presets
        */
@@ -3995,6 +4231,10 @@ export namespace WorkflowUpdateResponse {
         modelIdInput?: string;
       }
 
+      export interface OutputProperties {
+        label: string;
+      }
+
       export interface Preset {
         fields: Array<string>;
 
@@ -4288,7 +4528,9 @@ export namespace WorkflowListResponse {
      * 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
+     * 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';
 
@@ -4316,8 +4558,9 @@ export namespace WorkflowListResponse {
     maxDuration?: number;
 
     /**
-     * The maximum allowed length for \`string\` inputs. Also applies to each item in
-     * \`string_array\`.
+     * 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;
 
@@ -4334,8 +4577,9 @@ export namespace WorkflowListResponse {
     min?: number;
 
     /**
-     * The minimum allowed length for string inputs. Also applies to each item in
-     * \`string_array\`.
+     * 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;
 
@@ -4409,8 +4653,7 @@ export namespace WorkflowListResponse {
      * - \`ifNotDefined\`: Input is required when another specified input is not
      *   defined
      * - \`ifDefined\`: Input is required when another specified input is defined
-     * - \`conditionalValues\`: Input is required when another input has a specific
-     *   value
+     * - \`conditional\`: Input is required when other inputs have specific values
      *
      * By default, the input is not required.
      */
@@ -4430,8 +4673,7 @@ export namespace WorkflowListResponse {
      * - \`ifNotDefined\`: Input is required when another specified input is not
      *   defined
      * - \`ifDefined\`: Input is required when another specified input is defined
-     * - \`conditionalValues\`: Input is required when another input has a specific
-     *   value
+     * - \`conditional\`: Input is required when other inputs have specific values
      *
      * By default, the input is not required.
      */
@@ -4442,12 +4684,9 @@ export namespace WorkflowListResponse {
       always?: boolean;
 
       /**
-       * Makes this input required when another input has a specific value:
-       *
-       * - Key: name of the input to check
-       * - Value: operation and allowed values that trigger the requirement
+       * Makes this input required when other inputs have one of the listed values
        */
-      conditionalValues?: unknown;
+      conditional?: Required.Conditional;
 
       /**
        * Makes this input required when another input is defined:
@@ -4465,6 +4704,26 @@ export namespace WorkflowListResponse {
        */
       ifNotDefined?: unknown;
     }
+
+    export namespace Required {
+      /**
+       * Makes this input required when other inputs have one of the listed values
+       */
+      export interface Conditional {
+        /**
+         * The conditions to check:
+         *
+         * - Key: name of the input to check
+         * - Value: values of that input that satisfy the condition
+         */
+        values: unknown;
+
+        /**
+         * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+         */
+        operator?: 'and' | 'or';
+      }
+    }
   }
 
   /**
@@ -4518,6 +4777,7 @@ export namespace WorkflowListResponse {
       | 'remove-background'
       | 'transform'
       | 'user-approval'
+      | 'user-selection'
       | 'workflow';
 
     /**
@@ -4543,14 +4803,15 @@ export namespace WorkflowListResponse {
     includeOutputsInWorkflowJob?: true;
 
     /**
-     * The inputs of the node.
+     * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+     * bound how many items the user may pick (defaults: 1 and 100); conditional
+     * connections may be present as additional inputs.
      */
     inputs?: Array<Flow.Input>;
 
     /**
-     * Statically-configured items for a List node. The node outputs this array as-is
-     * when executed. Only available for List nodes. The values can be strings,
-     * numbers, or asset IDs.
+     * Statically-configured items for a List node, or the frozen candidate list of a
+     * UserSelection node. The values can be strings, numbers, or asset IDs.
      */
     items?: Array<string>;
 
@@ -4681,7 +4942,9 @@ export namespace WorkflowListResponse {
        * 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
+       * 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';
 
@@ -4709,8 +4972,9 @@ export namespace WorkflowListResponse {
       maxDuration?: number;
 
       /**
-       * The maximum allowed length for \`string\` inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -4727,8 +4991,9 @@ export namespace WorkflowListResponse {
       min?: number;
 
       /**
-       * The minimum allowed length for string inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -4808,8 +5073,7 @@ export namespace WorkflowListResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -4908,7 +5172,9 @@ export namespace WorkflowListResponse {
          * 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
+         * 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';
 
@@ -4936,8 +5202,9 @@ export namespace WorkflowListResponse {
         maxDuration?: number;
 
         /**
-         * The maximum allowed length for \`string\` inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -4954,8 +5221,9 @@ export namespace WorkflowListResponse {
         min?: number;
 
         /**
-         * The minimum allowed length for string inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -5035,8 +5303,7 @@ export namespace WorkflowListResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -5093,8 +5360,7 @@ export namespace WorkflowListResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -5105,12 +5371,9 @@ export namespace WorkflowListResponse {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -5128,6 +5391,26 @@ export namespace WorkflowListResponse {
            */
           ifNotDefined?: unknown;
         }
+
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
       }
 
       /**
@@ -5168,8 +5451,7 @@ export namespace WorkflowListResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -5180,12 +5462,9 @@ export namespace WorkflowListResponse {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -5203,6 +5482,26 @@ export namespace WorkflowListResponse {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -5262,6 +5561,11 @@ export namespace WorkflowListResponse {
      */
     lorasComponent?: UiConfig.LorasComponent;
 
+    /**
+     * Configuration for the provider outputs exposed by `exposeOutput`
+     */
+    outputProperties?: { [key: string]: UiConfig.OutputProperties };
+
     /**
      * Configuration for the presets
      */
@@ -5316,6 +5620,10 @@ export namespace WorkflowListResponse {
       modelIdInput?: string;
     }
 
+    export interface OutputProperties {
+      label: string;
+    }
+
     export interface Preset {
       fields: Array<string>;
 
@@ -5579,6 +5887,7 @@ export namespace WorkflowRunResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -5609,14 +5918,15 @@ export namespace WorkflowRunResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -5765,7 +6075,9 @@ export namespace WorkflowRunResponse {
            * 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
+           * 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';
 
@@ -5793,8 +6105,9 @@ export namespace WorkflowRunResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -5811,8 +6124,9 @@ export namespace WorkflowRunResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -5892,8 +6206,7 @@ export namespace WorkflowRunResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -5992,7 +6305,9 @@ export namespace WorkflowRunResponse {
              * 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
+             * 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';
 
@@ -6020,8 +6335,9 @@ export namespace WorkflowRunResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * 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;
 
@@ -6038,8 +6354,9 @@ export namespace WorkflowRunResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * 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;
 
@@ -6119,8 +6436,7 @@ export namespace WorkflowRunResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -6177,8 +6493,7 @@ export namespace WorkflowRunResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -6189,12 +6504,9 @@ export namespace WorkflowRunResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -6212,6 +6524,26 @@ export namespace WorkflowRunResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -6252,8 +6584,7 @@ export namespace WorkflowRunResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -6264,12 +6595,9 @@ export namespace WorkflowRunResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -6287,6 +6615,26 @@ export namespace WorkflowRunResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -6344,7 +6692,7 @@ export namespace WorkflowRunResponse {
 
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * 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.
@@ -6374,7 +6722,7 @@ export namespace WorkflowRunResponse {
     export namespace Billing {
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * 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.
@@ -6394,7 +6742,7 @@ export namespace WorkflowRunResponse {
       export interface CuCostDetails {
         'ip-detection'?: number;
 
-        'slop-detection'?: number;
+        'quality-gate'?: number;
       }
     }
   }
@@ -6557,6 +6905,7 @@ export namespace WorkflowRunResponse {
         | 'remove-background'
         | 'transform'
         | 'user-approval'
+        | 'user-selection'
         | 'workflow';
 
       /**
@@ -6582,14 +6931,15 @@ export namespace WorkflowRunResponse {
       includeOutputsInWorkflowJob?: true;
 
       /**
-       * The inputs of the node.
+       * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+       * bound how many items the user may pick (defaults: 1 and 100); conditional
+       * connections may be present as additional inputs.
        */
       inputs?: Array<Flow.Input>;
 
       /**
-       * Statically-configured items for a List node. The node outputs this array as-is
-       * when executed. Only available for List nodes. The values can be strings,
-       * numbers, or asset IDs.
+       * Statically-configured items for a List node, or the frozen candidate list of a
+       * UserSelection node. The values can be strings, numbers, or asset IDs.
        */
       items?: Array<string>;
 
@@ -6720,7 +7070,9 @@ export namespace WorkflowRunResponse {
          * 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
+         * 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';
 
@@ -6748,8 +7100,9 @@ export namespace WorkflowRunResponse {
         maxDuration?: number;
 
         /**
-         * The maximum allowed length for \`string\` inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -6766,8 +7119,9 @@ export namespace WorkflowRunResponse {
         min?: number;
 
         /**
-         * The minimum allowed length for string inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -6847,8 +7201,7 @@ export namespace WorkflowRunResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -6947,7 +7300,9 @@ export namespace WorkflowRunResponse {
            * 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
+           * 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';
 
@@ -6975,8 +7330,9 @@ export namespace WorkflowRunResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -6993,8 +7349,9 @@ export namespace WorkflowRunResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -7074,8 +7431,7 @@ export namespace WorkflowRunResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -7132,8 +7488,7 @@ export namespace WorkflowRunResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -7144,12 +7499,9 @@ export namespace WorkflowRunResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -7167,6 +7519,26 @@ export namespace WorkflowRunResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -7207,8 +7579,7 @@ export namespace WorkflowRunResponse {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -7219,12 +7590,9 @@ export namespace WorkflowRunResponse {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -7242,14 +7610,34 @@ export namespace WorkflowRunResponse {
            */
           ifNotDefined?: unknown;
         }
-      }
 
-      /**
-       * The logic of the node. Only available for logic nodes.
-       */
-      export interface Logic {
-        /**
-         * The cases of the logic. Only available for if/else nodes.
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
+      }
+
+      /**
+       * The logic of the node. Only available for logic nodes.
+       */
+      export interface Logic {
+        /**
+         * The cases of the logic. Only available for if/else nodes.
          */
         cases?: Array<Logic.Case>;
 
@@ -7356,7 +7744,9 @@ export namespace WorkflowRunResponse {
        * 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
+       * 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';
 
@@ -7384,8 +7774,9 @@ export namespace WorkflowRunResponse {
       maxDuration?: number;
 
       /**
-       * The maximum allowed length for \`string\` inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -7402,8 +7793,9 @@ export namespace WorkflowRunResponse {
       min?: number;
 
       /**
-       * The minimum allowed length for string inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -7477,8 +7869,7 @@ export namespace WorkflowRunResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -7498,8 +7889,7 @@ export namespace WorkflowRunResponse {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -7510,12 +7900,9 @@ export namespace WorkflowRunResponse {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -7533,6 +7920,26 @@ export namespace WorkflowRunResponse {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -7590,6 +7997,11 @@ export namespace WorkflowRunResponse {
        */
       lorasComponent?: UiConfig.LorasComponent;
 
+      /**
+       * Configuration for the provider outputs exposed by `exposeOutput`
+       */
+      outputProperties?: { [key: string]: UiConfig.OutputProperties };
+
       /**
        * Configuration for the presets
        */
@@ -7630,89 +8042,1143 @@ export namespace WorkflowRunResponse {
          */
         modelInput: string;
 
-        /**
-         * The input name of the scale (number_array)
-         */
-        scaleInput: string;
+        /**
+         * The input name of the scale (number_array)
+         */
+        scaleInput: string;
+
+        /**
+         * The input model id (example: a composition or a single LoRA modelId) If
+         * specified, the model id will be attached to the output asset as a metadata If
+         * the model-decomposer parser is specified on it, modelInput and scaleInput will
+         * be automatically populated
+         */
+        modelIdInput?: string;
+      }
+
+      export interface OutputProperties {
+        label: string;
+      }
+
+      export interface Preset {
+        fields: Array<string>;
+
+        presets: unknown;
+      }
+
+      /**
+       * Configuration for the resolution component
+       */
+      export interface ResolutionComponent {
+        /**
+         * The input name of the height
+         */
+        heightInput: string;
+
+        /**
+         * The label of the component
+         */
+        label: string;
+
+        /**
+         * The resolution presets
+         */
+        presets: Array<ResolutionComponent.Preset>;
+
+        /**
+         * The input name of the width
+         */
+        widthInput: string;
+      }
+
+      export namespace ResolutionComponent {
+        export interface Preset {
+          height: number;
+
+          label: string;
+
+          width: number;
+        }
+      }
+
+      /**
+       * Configuration for the trigger generate button
+       */
+      export interface TriggerGenerate {
+        label: string;
+
+        /**
+         * The 'name' of the input where the trigger generate button will be displayed
+         * (after the input). Do not specify both position and after.
+         */
+        after?: string;
+
+        /**
+         * The position of the trigger generate button. If position specified, the button
+         * will be displayed at the specified position. Do not specify both position and
+         * after.
+         */
+        position?: 'bottom' | 'top';
+      }
+    }
+  }
+}
+
+export interface WorkflowUserApprovalResponse {
+  job: WorkflowUserApprovalResponse.Job;
+}
+
+export namespace WorkflowUserApprovalResponse {
+  export interface Job {
+    /**
+     * The job creation date as an ISO string (example: "2023-02-03T11:19:41.579Z")
+     */
+    createdAt: string;
+
+    /**
+     * The job ID (example: "job_ocZCnG1Df35XRL1QyCZSRxAG8")
+     */
+    jobId: string;
+
+    /**
+     * The type of job
+     */
+    jobType:
+      | 'assets-download'
+      | 'canvas-export'
+      | 'caption'
+      | 'caption-llava'
+      | 'custom'
+      | 'describe-style'
+      | 'detection'
+      | 'embed'
+      | 'flux'
+      | 'flux-model-training'
+      | 'generate-prompt'
+      | 'image-generation'
+      | 'image-prompt-editing'
+      | 'inference'
+      | 'mesh-preview-rendering'
+      | 'model-download'
+      | 'model-import'
+      | 'model-training'
+      | 'musubi-model-training'
+      | 'openai-image-generation'
+      | 'patch-image'
+      | 'pixelate'
+      | 'reframe'
+      | 'remove-background'
+      | 'repaint'
+      | 'restyle'
+      | 'segment'
+      | 'skybox-3d'
+      | 'skybox-base-360'
+      | 'skybox-hdri'
+      | 'skybox-upscale-360'
+      | 'splat'
+      | 'texture'
+      | 'translate'
+      | 'upload'
+      | 'upscale'
+      | 'upscale-skybox'
+      | 'upscale-texture'
+      | 'vectorize'
+      | 'workflow';
+
+    /**
+     * Metadata of the job with some additional information
+     */
+    metadata: Job.Metadata;
+
+    /**
+     * Progress of the job (between 0 and 1)
+     */
+    progress: number;
+
+    /**
+     * The current status of the job
+     */
+    status:
+      | 'canceled'
+      | 'failure'
+      | 'finalizing'
+      | 'in-progress'
+      | 'pending'
+      | 'queued'
+      | 'success'
+      | 'warming-up';
+
+    /**
+     * The history of the different statuses the job went through with the ISO string
+     * date of when the job reached each statuses.
+     */
+    statusHistory: Array<Job.StatusHistory>;
+
+    /**
+     * The job last update date as an ISO string (example: "2023-02-03T11:19:41.579Z")
+     */
+    updatedAt: string;
+
+    /**
+     * The author user ID (example: "dcf121faaa1a0a0bbbd9ca1b73d62aea")
+     */
+    authorId?: string;
+
+    /**
+     * The billing of the job
+     */
+    billing?: Job.Billing;
+
+    /**
+     * The owner ID (example: "team_U3Qmc8PCdWXwAQJ4Dvw4tV6D")
+     */
+    ownerId?: string;
+  }
+
+  export namespace Job {
+    /**
+     * Metadata of the job with some additional information
+     */
+    export interface Metadata {
+      /**
+       * List of produced assets for this job
+       */
+      assetIds?: Array<string>;
+
+      /**
+       * Eventual error for the job
+       */
+      error?: string | null;
+
+      /**
+       * The flow of the job. Only available for workflow jobs.
+       */
+      flow?: Array<Metadata.Flow>;
+
+      /**
+       * Actionable hint for the user explaining what went wrong and how to resolve it.
+       */
+      hint?: string;
+
+      /**
+       * The inputs for the job
+       */
+      input?: { [key: string]: unknown };
+
+      /**
+       * May contain the output of the job for specific custom models jobs. Only
+       * available for custom models which generate non-assets outputs. Example: LLM text
+       * results.
+       */
+      output?: { [key: string]: unknown };
+
+      /**
+       * For voice-clone jobs: the ID of the model being trained.
+       */
+      outputModelId?: string;
+
+      /**
+       * The workflow ID of the job if job is part of a workflow.
+       */
+      workflowId?: string;
+
+      /**
+       * The workflow job ID of the job if job is part of a workflow job.
+       */
+      workflowJobId?: string;
+    }
+
+    export namespace Metadata {
+      export interface Flow {
+        /**
+         * The id of the node.
+         */
+        id: string;
+
+        /**
+         * The status of the node. Only available for WorkflowJob nodes.
+         */
+        status: 'failure' | 'pending' | 'processing' | 'rejected' | 'skipped' | 'success';
+
+        /**
+         * The type of the job for the node.
+         */
+        type:
+          | 'custom-model'
+          | 'for-each'
+          | 'generate-prompt'
+          | 'list'
+          | 'logic'
+          | 'model'
+          | 'remove-background'
+          | 'transform'
+          | 'user-approval'
+          | 'user-selection'
+          | 'workflow';
+
+        /**
+         * List of produced assets for this node.
+         */
+        assets?: Array<Flow.Asset>;
+
+        /**
+         * Fixed number of iterations for a ForEach node. When set, the loop runs exactly
+         * `count` times regardless of array input. When not set, the loop iterates over
+         * the resolved array input. Only available for ForEach nodes.
+         */
+        count?: number;
+
+        /**
+         * The nodes that this node depends on. Only available for nodes that have
+         * dependencies. Mainly used for user approval nodes.
+         */
+        dependsOn?: Array<string>;
+
+        /**
+         * If true, the outputs of this node will be included in the workflow job's final
+         * output. Only applicable to producing nodes (custom-model, inference, etc.). By
+         * default, only last nodes (nodes not referenced by other nodes) contribute to
+         * outputs. Set this to true to also include intermediate nodes in the final
+         * output. Note: This should only be set to `true` or left undefined.
+         */
+        includeOutputsInWorkflowJob?: true;
+
+        /**
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
+         */
+        inputs?: Array<Flow.Input>;
+
+        /**
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
+         */
+        items?: Array<string>;
+
+        /**
+         * Zero-based index of the iteration this node copy belongs to. Set on
+         * dynamically-created copies of loop body nodes.
+         */
+        iterationIndex?: number;
+
+        /**
+         * If the flow is part of a WorkflowJob, this is the jobId for the node. jobId is
+         * only available for nodes started. A node "Pending" for a running workflow job is
+         * not started.
+         */
+        jobId?: string;
+
+        /**
+         * The logic of the node. Only available for logic nodes.
+         */
+        logic?: Flow.Logic;
+
+        /**
+         * The type of the logic for the node. Only available for logic nodes.
+         */
+        logicType?: 'if-else';
+
+        /**
+         * IDs of the body template nodes that belong to this ForEach loop. At runtime
+         * these templates are cloned once per iteration and marked Skipped. Only available
+         * for ForEach nodes.
+         */
+        loopBodyNodeIds?: Array<string>;
+
+        /**
+         * ID of the ForEach node that spawned this iteration copy. Set on
+         * dynamically-created copies of loop body nodes.
+         */
+        loopNodeId?: string;
+
+        /**
+         * The model id for the node. Mainly used for custom model tasks.
+         */
+        modelId?: string;
+
+        /**
+         * The output of the node. Only available for logic nodes.
+         */
+        output?: unknown;
+
+        /**
+         * The workflow id for the node. Mainly used for workflow tasks.
+         */
+        workflowId?: string;
+      }
+
+      export namespace Flow {
+        export interface Asset {
+          assetId: string;
+
+          url: string;
+        }
+
+        /**
+         * This is used to run the flow.
+         */
+        export interface Input {
+          /**
+           * The name that must be user to call the model through the API
+           */
+          name: string;
+
+          /**
+           * The data type of the input
+           */
+          type:
+            | 'boolean'
+            | 'file'
+            | 'file_array'
+            | 'inputs_array'
+            | 'model'
+            | 'model_array'
+            | 'number'
+            | 'number_array'
+            | 'string'
+            | 'string_array';
+
+          /**
+           * The allowed values for the input. For \`string\` or \`number\` types, creates a
+           * single-select dropdown. For \`string_array\` type, creates a multi-select
+           * dropdown.
+           */
+          allowedValues?: Array<unknown>;
+
+          /**
+           * Specifies the background behavior for the input. Only available for \`file\` and
+           * \`file_array\` input types with kind \`image\`.
+           */
+          backgroundBehavior?: 'opaque' | 'transparent';
+
+          /**
+           * Whether the input is a color or not. Only available for \`string\` input type.
+           */
+          color?: boolean;
+
+          /**
+           * Whether this input affects the model's cost calculation
+           */
+          costImpact?: boolean;
+
+          /**
+           * The default value for the input
+           */
+          default?: unknown;
+
+          /**
+           * Help text displayed in the UI to provide additional information about the input
+           */
+          description?: string;
+
+          /**
+           * Used to visually group inputs together in the UI. Inputs with the same group
+           * value appear consecutively in the UI.
+           */
+          group?: string;
+
+          /**
+           * Hint text displayed in the UI as a tooltip to guide the user
+           */
+          hint?: string;
+
+          /**
+           * The list of inputs which form an object within a container array. All inputs are
+           * the same as the current object. This is only available for type inputs_array
+           * inputs.
+           */
+          inputs?: Array<{ [key: string]: unknown }>;
+
+          /**
+           * The configured items for inputs_array type inputs. Each item is an array of
+           * SubNodeInput that need ref/value resolution. Only available for inputs_array
+           * type.
+           */
+          items?: Array<Array<Input.Item>>;
+
+          /**
+           * The asset kind of the input. Only taken into account for \`file\` and
+           * \`file_array\` input types. If model provides multiple kinds, the input will be
+           * not able to create the asset on the flight on API side with dataurl without
+           * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+           * a model does not declare one, \`image\` is returned, which is the kind used at
+           * generation time.
+           */
+          kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
+
+          /**
+           * The label displayed in the UI for this input
+           */
+          label?: string;
+
+          /**
+           * The name of the file input field to use as the mask source
+           */
+          maskFrom?: string;
+
+          /**
+           * The maximum allowed value. Only available for \`number\` and \`array\` input
+           * types.
+           */
+          max?: number;
+
+          /**
+           * The maximum allowed media duration in seconds. Only applies to \`file\` and
+           * \`file_array\` input types for video and audio assets. Validated against
+           * \`asset.properties.duration\` at job creation time.
+           */
+          maxDuration?: number;
+
+          /**
+           * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
+           */
+          maxLength?: number;
+
+          /**
+           * The maximum allowed file size in bytes. Only applies to \`file\` and
+           * \`file_array\` input types. Validated against \`asset.properties.size\` at job
+           * creation time.
+           */
+          maxSize?: number;
+
+          /**
+           * The minimum allowed value. Only available for \`number\` and array input types.
+           */
+          min?: number;
+
+          /**
+           * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
+           */
+          minLength?: number;
+
+          /**
+           * The allowed model types for this input. Example: \`["flux.1-lora"]\`. Only
+           * available for \`model_array\` input type.
+           */
+          modelTypes?: Array<
+            | 'custom'
+            | 'elevenlabs-voice'
+            | 'flux.1'
+            | 'flux.1-composition'
+            | 'flux.1-kontext-dev'
+            | 'flux.1-kontext-lora'
+            | 'flux.1-krea-dev'
+            | 'flux.1-krea-lora'
+            | 'flux.1-lora'
+            | 'flux.1-pro'
+            | 'flux.1.1-pro-ultra'
+            | 'flux.2-dev-edit-lora'
+            | 'flux.2-dev-lora'
+            | 'flux.2-klein-4b-edit-lora'
+            | 'flux.2-klein-4b-lora'
+            | 'flux.2-klein-9b-edit-lora'
+            | 'flux.2-klein-9b-lora'
+            | 'flux.2-klein-base-4b-edit-lora'
+            | 'flux.2-klein-base-4b-lora'
+            | 'flux.2-klein-base-9b-edit-lora'
+            | 'flux.2-klein-base-9b-lora'
+            | 'flux1.1-pro'
+            | 'gpt-image-1'
+            | 'qwen-image-2512-lora'
+            | 'qwen-image-edit-2509-lora'
+            | 'qwen-image-edit-2511-lora'
+            | 'qwen-image-edit-lora'
+            | 'qwen-image-lora'
+            | 'zimage-de-turbo-lora'
+            | 'zimage-lora'
+            | 'zimage-turbo-lora'
+          >;
+
+          /**
+           * Whether this input represents a parent asset to assign to the produced assets.
+           * Only available for \`file\` and \`file_array\` input types.
+           *
+           * For \`file_array\`, the parent asset is the first item in the array.
+           */
+          parent?: boolean;
+
+          /**
+           * Placeholder text for the input. Only available for 'string' input type.
+           */
+          placeholder?: string;
+
+          /**
+           * Whether the input is a prompt. When true, displays as a text area with prompt
+           * spark feature. Only available for \`string\` input type.
+           */
+          prompt?: boolean;
+
+          /**
+           * Whether the input is used with prompt spark. Only available for \`string\` input
+           * type.
+           */
+          promptSpark?: boolean;
+
+          /**
+           * The reference to another input or output of the same workflow. Must have at
+           * least one of node or conditional.
+           */
+          ref?: Input.Ref;
+
+          /**
+           * Set of rules that describes when this input is required:
+           *
+           * - \`always\`: Input is always required
+           * - \`ifNotDefined\`: Input is required when another specified input is not
+           *   defined
+           * - \`ifDefined\`: Input is required when another specified input is defined
+           * - \`conditional\`: Input is required when other inputs have specific values
+           *
+           * By default, the input is not required.
+           */
+          required?: Input.Required;
+
+          /**
+           * The step increment for numeric inputs. Only available for \`number\` input type.
+           */
+          step?: number;
+
+          /**
+           * The value of the input. This is the value of the input that will be used to run
+           * the node. Only available for flows managed by a WorkflowJob.
+           */
+          value?: unknown;
+        }
+
+        export namespace Input {
+          /**
+           * A sub-input within an inputs_array item. Same as NodeInput but without the
+           * recursive items field.
+           */
+          export interface Item {
+            /**
+             * The name that must be user to call the model through the API
+             */
+            name: string;
+
+            /**
+             * The data type of the input
+             */
+            type:
+              | 'boolean'
+              | 'file'
+              | 'file_array'
+              | 'inputs_array'
+              | 'model'
+              | 'model_array'
+              | 'number'
+              | 'number_array'
+              | 'string'
+              | 'string_array';
+
+            /**
+             * The allowed values for the input. For \`string\` or \`number\` types, creates a
+             * single-select dropdown. For \`string_array\` type, creates a multi-select
+             * dropdown.
+             */
+            allowedValues?: Array<unknown>;
+
+            /**
+             * Specifies the background behavior for the input. Only available for \`file\` and
+             * \`file_array\` input types with kind \`image\`.
+             */
+            backgroundBehavior?: 'opaque' | 'transparent';
+
+            /**
+             * Whether the input is a color or not. Only available for \`string\` input type.
+             */
+            color?: boolean;
+
+            /**
+             * Whether this input affects the model's cost calculation
+             */
+            costImpact?: boolean;
+
+            /**
+             * The default value for the input
+             */
+            default?: unknown;
+
+            /**
+             * Help text displayed in the UI to provide additional information about the input
+             */
+            description?: string;
+
+            /**
+             * Used to visually group inputs together in the UI. Inputs with the same group
+             * value appear consecutively in the UI.
+             */
+            group?: string;
+
+            /**
+             * Hint text displayed in the UI as a tooltip to guide the user
+             */
+            hint?: string;
+
+            /**
+             * The list of inputs which form an object within a container array. All inputs are
+             * the same as the current object. This is only available for type inputs_array
+             * inputs.
+             */
+            inputs?: Array<{ [key: string]: unknown }>;
+
+            /**
+             * The asset kind of the input. Only taken into account for \`file\` and
+             * \`file_array\` input types. If model provides multiple kinds, the input will be
+             * not able to create the asset on the flight on API side with dataurl without
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
+             */
+            kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
+
+            /**
+             * The label displayed in the UI for this input
+             */
+            label?: string;
+
+            /**
+             * The name of the file input field to use as the mask source
+             */
+            maskFrom?: string;
+
+            /**
+             * The maximum allowed value. Only available for \`number\` and \`array\` input
+             * types.
+             */
+            max?: number;
+
+            /**
+             * The maximum allowed media duration in seconds. Only applies to \`file\` and
+             * \`file_array\` input types for video and audio assets. Validated against
+             * \`asset.properties.duration\` at job creation time.
+             */
+            maxDuration?: number;
+
+            /**
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
+             */
+            maxLength?: number;
+
+            /**
+             * The maximum allowed file size in bytes. Only applies to \`file\` and
+             * \`file_array\` input types. Validated against \`asset.properties.size\` at job
+             * creation time.
+             */
+            maxSize?: number;
+
+            /**
+             * The minimum allowed value. Only available for \`number\` and array input types.
+             */
+            min?: number;
+
+            /**
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
+             */
+            minLength?: number;
+
+            /**
+             * The allowed model types for this input. Example: \`["flux.1-lora"]\`. Only
+             * available for \`model_array\` input type.
+             */
+            modelTypes?: Array<
+              | 'custom'
+              | 'elevenlabs-voice'
+              | 'flux.1'
+              | 'flux.1-composition'
+              | 'flux.1-kontext-dev'
+              | 'flux.1-kontext-lora'
+              | 'flux.1-krea-dev'
+              | 'flux.1-krea-lora'
+              | 'flux.1-lora'
+              | 'flux.1-pro'
+              | 'flux.1.1-pro-ultra'
+              | 'flux.2-dev-edit-lora'
+              | 'flux.2-dev-lora'
+              | 'flux.2-klein-4b-edit-lora'
+              | 'flux.2-klein-4b-lora'
+              | 'flux.2-klein-9b-edit-lora'
+              | 'flux.2-klein-9b-lora'
+              | 'flux.2-klein-base-4b-edit-lora'
+              | 'flux.2-klein-base-4b-lora'
+              | 'flux.2-klein-base-9b-edit-lora'
+              | 'flux.2-klein-base-9b-lora'
+              | 'flux1.1-pro'
+              | 'gpt-image-1'
+              | 'qwen-image-2512-lora'
+              | 'qwen-image-edit-2509-lora'
+              | 'qwen-image-edit-2511-lora'
+              | 'qwen-image-edit-lora'
+              | 'qwen-image-lora'
+              | 'zimage-de-turbo-lora'
+              | 'zimage-lora'
+              | 'zimage-turbo-lora'
+            >;
+
+            /**
+             * Whether this input represents a parent asset to assign to the produced assets.
+             * Only available for \`file\` and \`file_array\` input types.
+             *
+             * For \`file_array\`, the parent asset is the first item in the array.
+             */
+            parent?: boolean;
+
+            /**
+             * Placeholder text for the input. Only available for 'string' input type.
+             */
+            placeholder?: string;
+
+            /**
+             * Whether the input is a prompt. When true, displays as a text area with prompt
+             * spark feature. Only available for \`string\` input type.
+             */
+            prompt?: boolean;
+
+            /**
+             * Whether the input is used with prompt spark. Only available for \`string\` input
+             * type.
+             */
+            promptSpark?: boolean;
+
+            /**
+             * The reference to another input or output of the same workflow. Must have at
+             * least one of node or conditional.
+             */
+            ref?: Item.Ref;
+
+            /**
+             * Set of rules that describes when this input is required:
+             *
+             * - \`always\`: Input is always required
+             * - \`ifNotDefined\`: Input is required when another specified input is not
+             *   defined
+             * - \`ifDefined\`: Input is required when another specified input is defined
+             * - \`conditional\`: Input is required when other inputs have specific values
+             *
+             * By default, the input is not required.
+             */
+            required?: Item.Required;
+
+            /**
+             * The step increment for numeric inputs. Only available for \`number\` input type.
+             */
+            step?: number;
+
+            /**
+             * The value of the input. This is the value of the input that will be used to run
+             * the node. Only available for flows managed by a WorkflowJob.
+             */
+            value?: unknown;
+          }
+
+          export namespace Item {
+            /**
+             * The reference to another input or output of the same workflow. Must have at
+             * least one of node or conditional.
+             */
+            export interface Ref {
+              /**
+               * The conditional nodes to reference. If the conditional nodes are successful, the
+               * node will be successful. If the conditional nodes are skipped, the node will be
+               * skipped. Contains an array of node ids used to check the status of the nodes.
+               */
+              conditional?: Array<string>;
+
+              /**
+               * This is the desired node output value if ref is an if/else node.
+               */
+              equal?: string;
+
+              /**
+               * The name of the input or output to reference. If the type is 'workflow', the
+               * name is the name of the input of the workflow is required If the type is 'node',
+               * the name is not mandatory, except if you want all outputs of the node. To get
+               * all outputs of a node, you can use the name 'all'.
+               */
+              name?: string;
+
+              /**
+               * The node id or 'workflow' if the source is a workflow input.
+               */
+              node?: string;
+            }
+
+            /**
+             * Set of rules that describes when this input is required:
+             *
+             * - \`always\`: Input is always required
+             * - \`ifNotDefined\`: Input is required when another specified input is not
+             *   defined
+             * - \`ifDefined\`: Input is required when another specified input is defined
+             * - \`conditional\`: Input is required when other inputs have specific values
+             *
+             * By default, the input is not required.
+             */
+            export interface Required {
+              /**
+               * Whether the input is always required
+               */
+              always?: boolean;
+
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              conditional?: Required.Conditional;
+
+              /**
+               * Makes this input required when another input is defined:
+               *
+               * - Key: name of the input that must be defined
+               * - Value: message to display when this input is required
+               */
+              ifDefined?: unknown;
+
+              /**
+               * Makes this input required when another input is not defined:
+               *
+               * - Key: name of the input that must be undefined
+               * - Value: message to display when this input is required
+               */
+              ifNotDefined?: unknown;
+            }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
+          }
+
+          /**
+           * The reference to another input or output of the same workflow. Must have at
+           * least one of node or conditional.
+           */
+          export interface Ref {
+            /**
+             * The conditional nodes to reference. If the conditional nodes are successful, the
+             * node will be successful. If the conditional nodes are skipped, the node will be
+             * skipped. Contains an array of node ids used to check the status of the nodes.
+             */
+            conditional?: Array<string>;
+
+            /**
+             * This is the desired node output value if ref is an if/else node.
+             */
+            equal?: string;
+
+            /**
+             * The name of the input or output to reference. If the type is 'workflow', the
+             * name is the name of the input of the workflow is required If the type is 'node',
+             * the name is not mandatory, except if you want all outputs of the node. To get
+             * all outputs of a node, you can use the name 'all'.
+             */
+            name?: string;
+
+            /**
+             * The node id or 'workflow' if the source is a workflow input.
+             */
+            node?: string;
+          }
+
+          /**
+           * Set of rules that describes when this input is required:
+           *
+           * - \`always\`: Input is always required
+           * - \`ifNotDefined\`: Input is required when another specified input is not
+           *   defined
+           * - \`ifDefined\`: Input is required when another specified input is defined
+           * - \`conditional\`: Input is required when other inputs have specific values
+           *
+           * By default, the input is not required.
+           */
+          export interface Required {
+            /**
+             * Whether the input is always required
+             */
+            always?: boolean;
+
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            conditional?: Required.Conditional;
+
+            /**
+             * Makes this input required when another input is defined:
+             *
+             * - Key: name of the input that must be defined
+             * - Value: message to display when this input is required
+             */
+            ifDefined?: unknown;
+
+            /**
+             * Makes this input required when another input is not defined:
+             *
+             * - Key: name of the input that must be undefined
+             * - Value: message to display when this input is required
+             */
+            ifNotDefined?: unknown;
+          }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
+        }
 
         /**
-         * The input model id (example: a composition or a single LoRA modelId) If
-         * specified, the model id will be attached to the output asset as a metadata If
-         * the model-decomposer parser is specified on it, modelInput and scaleInput will
-         * be automatically populated
+         * The logic of the node. Only available for logic nodes.
          */
-        modelIdInput?: string;
-      }
+        export interface Logic {
+          /**
+           * The cases of the logic. Only available for if/else nodes.
+           */
+          cases?: Array<Logic.Case>;
 
-      export interface Preset {
-        fields: Array<string>;
+          /**
+           * 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;
 
-        presets: unknown;
-      }
+          /**
+           * The transform of the logic. Only available for transform nodes.
+           */
+          transform?: string;
+        }
 
-      /**
-       * Configuration for the resolution component
-       */
-      export interface ResolutionComponent {
-        /**
-         * The input name of the height
-         */
-        heightInput: string;
+        export namespace Logic {
+          export interface Case {
+            condition: string;
 
-        /**
-         * The label of the component
-         */
-        label: string;
+            value: string;
+          }
+        }
+      }
+    }
 
-        /**
-         * The resolution presets
-         */
-        presets: Array<ResolutionComponent.Preset>;
+    export interface StatusHistory {
+      date: string;
 
-        /**
-         * The input name of the width
-         */
-        widthInput: string;
-      }
+      status:
+        | 'canceled'
+        | 'failure'
+        | 'finalizing'
+        | 'in-progress'
+        | 'pending'
+        | 'queued'
+        | 'success'
+        | 'warming-up';
+    }
 
-      export namespace ResolutionComponent {
-        export interface Preset {
-          height: number;
+    /**
+     * The billing of the job
+     */
+    export interface Billing {
+      cuCost: number;
 
-          label: string;
+      cuDiscount: number;
 
-          width: 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;
 
       /**
-       * Configuration for the trigger generate button
+       * 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.
        */
-      export interface TriggerGenerate {
-        label: string;
+      disableRefund?: boolean;
+    }
 
-        /**
-         * The 'name' of the input where the trigger generate button will be displayed
-         * (after the input). Do not specify both position and after.
-         */
-        after?: string;
+    export namespace Billing {
+      /**
+       * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
+       * top of the generation itself, such as `quality-gate`.
+       *
+       * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+       * values here.
+       *
+       * Two caveats when displaying it:
+       *
+       * - These are a remaining refundable balance, not a receipt: a job that failed or
+       *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+       *   still shows the main action's original charge.
+       * - `ip-detection` is part of the shape but is never populated today: that fee is
+       *   charged outside the job and reported once, as
+       *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+       *   it.
+       *
+       * Absent when the job paid for no add-on.
+       */
+      export interface CuCostDetails {
+        'ip-detection'?: number;
 
-        /**
-         * The position of the trigger generate button. If position specified, the button
-         * will be displayed at the specified position. Do not specify both position and
-         * after.
-         */
-        position?: 'bottom' | 'top';
+        'quality-gate'?: number;
       }
     }
   }
 }
 
-export interface WorkflowUserApprovalResponse {
-  job: WorkflowUserApprovalResponse.Job;
+export interface WorkflowUserSelectionResponse {
+  job: WorkflowUserSelectionResponse.Job;
 }
 
-export namespace WorkflowUserApprovalResponse {
+export namespace WorkflowUserSelectionResponse {
   export interface Job {
     /**
      * The job creation date as an ISO string (example: "2023-02-03T11:19:41.579Z")
@@ -7897,6 +9363,7 @@ export namespace WorkflowUserApprovalResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -7927,14 +9394,15 @@ export namespace WorkflowUserApprovalResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -8083,7 +9551,9 @@ export namespace WorkflowUserApprovalResponse {
            * 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
+           * 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';
 
@@ -8111,8 +9581,9 @@ export namespace WorkflowUserApprovalResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -8129,8 +9600,9 @@ export namespace WorkflowUserApprovalResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * 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;
 
@@ -8210,8 +9682,7 @@ export namespace WorkflowUserApprovalResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -8310,7 +9781,9 @@ export namespace WorkflowUserApprovalResponse {
              * 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
+             * 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';
 
@@ -8338,8 +9811,9 @@ export namespace WorkflowUserApprovalResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * 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;
 
@@ -8356,8 +9830,9 @@ export namespace WorkflowUserApprovalResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * 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;
 
@@ -8437,8 +9912,7 @@ export namespace WorkflowUserApprovalResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -8495,8 +9969,7 @@ export namespace WorkflowUserApprovalResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -8507,12 +9980,9 @@ export namespace WorkflowUserApprovalResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -8530,6 +10000,26 @@ export namespace WorkflowUserApprovalResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -8570,8 +10060,7 @@ export namespace WorkflowUserApprovalResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -8582,12 +10071,9 @@ export namespace WorkflowUserApprovalResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -8605,6 +10091,26 @@ export namespace WorkflowUserApprovalResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -8662,7 +10168,7 @@ export namespace WorkflowUserApprovalResponse {
 
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * 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.
@@ -8692,7 +10198,7 @@ export namespace WorkflowUserApprovalResponse {
     export namespace Billing {
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * 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.
@@ -8712,7 +10218,7 @@ export namespace WorkflowUserApprovalResponse {
       export interface CuCostDetails {
         'ip-detection'?: number;
 
-        'slop-detection'?: number;
+        'quality-gate'?: number;
       }
     }
   }
@@ -8737,14 +10243,19 @@ export interface WorkflowCreateParams {
 }
 
 export interface WorkflowRetrieveParams {
-  projectId?: unknown;
+  /**
+   * 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
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
    */
-  projectId?: unknown;
+  projectId?: string;
 
   /**
    * Body param: The after asset of the workflow. Set to null to unset the after
@@ -8849,6 +10360,7 @@ export namespace WorkflowUpdateParams {
       | 'remove-background'
       | 'transform'
       | 'user-approval'
+      | 'user-selection'
       | 'workflow';
 
     /**
@@ -8874,14 +10386,15 @@ export namespace WorkflowUpdateParams {
     includeOutputsInWorkflowJob?: true;
 
     /**
-     * The inputs of the node.
+     * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+     * bound how many items the user may pick (defaults: 1 and 100); conditional
+     * connections may be present as additional inputs.
      */
     inputs?: Array<Flow.Input>;
 
     /**
-     * Statically-configured items for a List node. The node outputs this array as-is
-     * when executed. Only available for List nodes. The values can be strings,
-     * numbers, or asset IDs.
+     * Statically-configured items for a List node, or the frozen candidate list of a
+     * UserSelection node. The values can be strings, numbers, or asset IDs.
      */
     items?: Array<string>;
 
@@ -9012,7 +10525,9 @@ export namespace WorkflowUpdateParams {
        * 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
+       * 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';
 
@@ -9040,8 +10555,9 @@ export namespace WorkflowUpdateParams {
       maxDuration?: number;
 
       /**
-       * The maximum allowed length for \`string\` inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -9058,8 +10574,9 @@ export namespace WorkflowUpdateParams {
       min?: number;
 
       /**
-       * The minimum allowed length for string inputs. Also applies to each item in
-       * \`string_array\`.
+       * 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;
 
@@ -9139,8 +10656,7 @@ export namespace WorkflowUpdateParams {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -9239,7 +10755,9 @@ export namespace WorkflowUpdateParams {
          * 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
+         * 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';
 
@@ -9267,8 +10785,9 @@ export namespace WorkflowUpdateParams {
         maxDuration?: number;
 
         /**
-         * The maximum allowed length for \`string\` inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -9285,8 +10804,9 @@ export namespace WorkflowUpdateParams {
         min?: number;
 
         /**
-         * The minimum allowed length for string inputs. Also applies to each item in
-         * \`string_array\`.
+         * 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;
 
@@ -9366,8 +10886,7 @@ export namespace WorkflowUpdateParams {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -9424,8 +10943,7 @@ export namespace WorkflowUpdateParams {
          * - \`ifNotDefined\`: Input is required when another specified input is not
          *   defined
          * - \`ifDefined\`: Input is required when another specified input is defined
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
+         * - \`conditional\`: Input is required when other inputs have specific values
          *
          * By default, the input is not required.
          */
@@ -9436,12 +10954,9 @@ export namespace WorkflowUpdateParams {
           always?: boolean;
 
           /**
-           * Makes this input required when another input has a specific value:
-           *
-           * - Key: name of the input to check
-           * - Value: operation and allowed values that trigger the requirement
+           * Makes this input required when other inputs have one of the listed values
            */
-          conditionalValues?: unknown;
+          conditional?: Required.Conditional;
 
           /**
            * Makes this input required when another input is defined:
@@ -9459,6 +10974,26 @@ export namespace WorkflowUpdateParams {
            */
           ifNotDefined?: unknown;
         }
+
+        export namespace Required {
+          /**
+           * Makes this input required when other inputs have one of the listed values
+           */
+          export interface Conditional {
+            /**
+             * The conditions to check:
+             *
+             * - Key: name of the input to check
+             * - Value: values of that input that satisfy the condition
+             */
+            values: unknown;
+
+            /**
+             * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+             */
+            operator?: 'and' | 'or';
+          }
+        }
       }
 
       /**
@@ -9499,8 +11034,7 @@ export namespace WorkflowUpdateParams {
        * - \`ifNotDefined\`: Input is required when another specified input is not
        *   defined
        * - \`ifDefined\`: Input is required when another specified input is defined
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * - \`conditional\`: Input is required when other inputs have specific values
        *
        * By default, the input is not required.
        */
@@ -9511,12 +11045,9 @@ export namespace WorkflowUpdateParams {
         always?: boolean;
 
         /**
-         * Makes this input required when another input has a specific value:
-         *
-         * - Key: name of the input to check
-         * - Value: operation and allowed values that trigger the requirement
+         * Makes this input required when other inputs have one of the listed values
          */
-        conditionalValues?: unknown;
+        conditional?: Required.Conditional;
 
         /**
          * Makes this input required when another input is defined:
@@ -9534,6 +11065,26 @@ export namespace WorkflowUpdateParams {
          */
         ifNotDefined?: unknown;
       }
+
+      export namespace Required {
+        /**
+         * Makes this input required when other inputs have one of the listed values
+         */
+        export interface Conditional {
+          /**
+           * The conditions to check:
+           *
+           * - Key: name of the input to check
+           * - Value: values of that input that satisfy the condition
+           */
+          values: unknown;
+
+          /**
+           * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+           */
+          operator?: 'and' | 'or';
+        }
+      }
     }
 
     /**
@@ -9648,7 +11199,9 @@ export namespace WorkflowUpdateParams {
      * 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
+     * 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';
 
@@ -9676,8 +11229,9 @@ export namespace WorkflowUpdateParams {
     maxDuration?: number;
 
     /**
-     * The maximum allowed length for \`string\` inputs. Also applies to each item in
-     * \`string_array\`.
+     * 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;
 
@@ -9694,8 +11248,9 @@ export namespace WorkflowUpdateParams {
     min?: number;
 
     /**
-     * The minimum allowed length for string inputs. Also applies to each item in
-     * \`string_array\`.
+     * 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;
 
@@ -9769,8 +11324,7 @@ export namespace WorkflowUpdateParams {
      * - \`ifNotDefined\`: Input is required when another specified input is not
      *   defined
      * - \`ifDefined\`: Input is required when another specified input is defined
-     * - \`conditionalValues\`: Input is required when another input has a specific
-     *   value
+     * - \`conditional\`: Input is required when other inputs have specific values
      *
      * By default, the input is not required.
      */
@@ -9790,8 +11344,7 @@ export namespace WorkflowUpdateParams {
      * - \`ifNotDefined\`: Input is required when another specified input is not
      *   defined
      * - \`ifDefined\`: Input is required when another specified input is defined
-     * - \`conditionalValues\`: Input is required when another input has a specific
-     *   value
+     * - \`conditional\`: Input is required when other inputs have specific values
      *
      * By default, the input is not required.
      */
@@ -9802,12 +11355,9 @@ export namespace WorkflowUpdateParams {
       always?: boolean;
 
       /**
-       * Makes this input required when another input has a specific value:
-       *
-       * - Key: name of the input to check
-       * - Value: operation and allowed values that trigger the requirement
+       * Makes this input required when other inputs have one of the listed values
        */
-      conditionalValues?: unknown;
+      conditional?: Required.Conditional;
 
       /**
        * Makes this input required when another input is defined:
@@ -9825,6 +11375,26 @@ export namespace WorkflowUpdateParams {
        */
       ifNotDefined?: unknown;
     }
+
+    export namespace Required {
+      /**
+       * Makes this input required when other inputs have one of the listed values
+       */
+      export interface Conditional {
+        /**
+         * The conditions to check:
+         *
+         * - Key: name of the input to check
+         * - Value: values of that input that satisfy the condition
+         */
+        values: unknown;
+
+        /**
+         * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+         */
+        operator?: 'and' | 'or';
+      }
+    }
   }
 }
 
@@ -9870,11 +11440,19 @@ export interface WorkflowListParams extends WorkflowsCursorParams {
    */
   status?: 'draft' | 'ready';
 
-  tags?: unknown;
+  /**
+   * The tags of the workflows to return, separated by commas. Example:
+   * `tag1,tag2,tag3` or `tag1`. Optional.
+   */
+  tags?: string;
 }
 
 export interface WorkflowDeleteParams {
-  projectId?: unknown;
+  /**
+   * The projectId used for ownership resource management. Either to assert ownership
+   * or to set the owner of the resource(s)
+   */
+  projectId?: string;
 }
 
 export interface WorkflowGetTagsParams {
@@ -9884,7 +11462,10 @@ export interface WorkflowGetTagsParams {
    */
   projectId?: string;
 
-  status?: unknown;
+  /**
+   * Only collect tags from workflows in this status. Default `ready`.
+   */
+  status?: 'draft' | 'ready' | 'deleted';
 }
 
 export interface WorkflowRunParams {
@@ -9895,21 +11476,24 @@ export interface WorkflowRunParams {
   body: unknown;
 
   /**
-   * Query param
+   * Query param: Estimate the operation instead of running it: the call returns a
+   * 269 response carrying the creative units cost. `api` estimates at the API tier.
    */
-  dryRun?: unknown;
+  dryRun?: 'true' | 'api';
 
   /**
-   * Query param
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
    */
-  projectId?: unknown;
+  projectId?: string;
 }
 
 export interface WorkflowUserApprovalParams {
   /**
-   * Query param
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
    */
-  projectId: unknown;
+  projectId: string;
 
   /**
    * Body param: The ID of the user approval node to act on in the workflow
@@ -9930,11 +11514,44 @@ 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
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
    */
-  projectId: unknown;
+  projectId: string;
 
   /**
    * Body param: The ID of the user approval node to act on in the workflow
@@ -9965,6 +11582,7 @@ export declare namespace Workflows {
     type WorkflowGetTagsResponse as WorkflowGetTagsResponse,
     type WorkflowRunResponse as WorkflowRunResponse,
     type WorkflowUserApprovalResponse as WorkflowUserApprovalResponse,
+    type WorkflowUserSelectionResponse as WorkflowUserSelectionResponse,
     type WorkflowListResponsesWorkflowsCursor as WorkflowListResponsesWorkflowsCursor,
     type WorkflowCreateParams as WorkflowCreateParams,
     type WorkflowRetrieveParams as WorkflowRetrieveParams,
@@ -9974,6 +11592,7 @@ export declare namespace Workflows {
     type WorkflowGetTagsParams as WorkflowGetTagsParams,
     type WorkflowRunParams as WorkflowRunParams,
     type WorkflowUserApprovalParams as WorkflowUserApprovalParams,
+    type WorkflowUserSelectionParams as WorkflowUserSelectionParams,
     type WorkflowApproveUserParams as WorkflowApproveUserParams,
   };
 }