@scenario-labs/sdk 0.2.0 → 1.0.0

package/src/resources/workflows.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../core/resource';
 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';
 
@@ -37,8 +38,11 @@ export class Workflows extends APIResource {
   list(
     query: WorkflowListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<WorkflowListResponse> {
-    return this._client.get('/workflows', { query, ...options });
+  ): PagePromise<WorkflowListResponsesWorkflowsCursor, WorkflowListResponse> {
+    return this._client.getAPIList('/workflows', WorkflowsCursor<WorkflowListResponse>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -87,6 +91,8 @@ export class Workflows extends APIResource {
   }
 }
 
+export type WorkflowListResponsesWorkflowsCursor = WorkflowsCursor<WorkflowListResponse>;
+
 export interface WorkflowCreateResponse {
   workflow: WorkflowCreateResponse.Workflow;
 }
@@ -4002,254 +4008,472 @@ export namespace WorkflowUpdateResponse {
   }
 }
 
-/**
- * Returns a paginated list of workflows. Supports both public access (via the
- * `Authorization` header set to `public-auth-token`) and authenticated user access
- * (including API keys). Public responses exclude some attributes.
- */
 export interface WorkflowListResponse {
-  workflows: Array<WorkflowListResponse.Workflow>;
+  /**
+   * Unique identifier of the workflow.
+   */
+  id: string;
 
   /**
-   * A token to query the next page of workflows
+   * User that created the workflow.
    */
-  nextPaginationToken?: string;
-}
+  authorId: string;
 
-export namespace WorkflowListResponse {
-  export interface Workflow {
-    /**
-     * Unique identifier of the workflow.
-     */
-    id: string;
+  /**
+   * ISO string
+   */
+  createdAt: string;
 
-    /**
-     * User that created the workflow.
-     */
-    authorId: string;
+  /**
+   * Full description of what the workflow does.
+   */
+  description: string;
 
-    /**
-     * ISO string
-     */
-    createdAt: string;
+  /**
+   * The UI data about the workflow. This is managed by scenario webapp.
+   */
+  editorInfo: { [key: string]: unknown };
 
-    /**
-     * Full description of what the workflow does.
-     */
-    description: string;
+  /**
+   * The flow of the workflow.
+   */
+  flow: Array<WorkflowListResponse.Flow>;
 
-    /**
-     * The UI data about the workflow. This is managed by scenario webapp.
-     */
-    editorInfo: { [key: string]: unknown };
+  /**
+   * The inputs of the workflow.
+   */
+  inputs: Array<WorkflowListResponse.Input>;
 
-    /**
-     * The flow of the workflow.
-     */
-    flow: Array<Workflow.Flow>;
+  /**
+   * Human-readable name of the workflow.
+   */
+  name: string;
 
-    /**
-     * The inputs of the workflow.
-     */
-    inputs: Array<Workflow.Input>;
+  /**
+   * Project that owns the workflow.
+   */
+  ownerId: string;
 
-    /**
-     * Human-readable name of the workflow.
-     */
-    name: string;
+  /**
+   * Visibility setting for the workflow.
+   */
+  privacy: 'private' | 'public' | 'unlisted';
 
-    /**
-     * Project that owns the workflow.
-     */
-    ownerId: string;
+  /**
+   * Short summary of the workflow.
+   */
+  shortDescription: string;
 
-    /**
-     * Visibility setting for the workflow.
-     */
-    privacy: 'private' | 'public' | 'unlisted';
+  /**
+   * Current lifecycle status (draft, ready, deleted).
+   */
+  status: 'deleted' | 'draft' | 'ready';
 
-    /**
-     * Short summary of the workflow.
-     */
-    shortDescription: string;
+  /**
+   * The tag set of the workflow.
+   */
+  tagSet: Array<string>;
+
+  /**
+   * ISO string
+   */
+  updatedAt: string;
+
+  /**
+   * A representation of an asset after being processed by the workflow
+   */
+  after?: WorkflowListResponse.After;
+
+  /**
+   * A representation of an asset before being processed by the workflow
+   */
+  before?: WorkflowListResponse.Before;
+
+  /**
+   * Embedding is a map of embedding version into embedding date
+   */
+  embedding?: unknown;
+
+  /**
+   * Whether the workflow is locked. Locked workflows cannot be modified or deleted
+   * except by the author or a project admin.
+   */
+  isLocked?: boolean;
 
+  lastIndexedAt?: string;
+
+  /**
+   * The type of indexing operation to perform in MeiliSearch
+   */
+  lastIndexingType?: 'CREATE' | 'DELETE' | 'UPDATE';
+
+  /**
+   * Timestamp when the workflow flow was last saved as a Ready (App) snapshot. Used
+   * to compute the WorkflowNodes snapshot key. Only set for workflows that have been
+   * in the Ready state.
+   */
+  lastReadyFlowUpdatedAt?: string;
+
+  /**
+   * ISO string timestamp when lock state was last changed.
+   */
+  lockedStateChangedAt?: string;
+
+  /**
+   * UserId of the user who last changed the lock state.
+   */
+  lockedStateChangedBy?: string;
+
+  /**
+   * Asset kinds produced by this workflow (if specified).
+   */
+  outputAssetKinds?: Array<'3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video'>;
+
+  /**
+   * Currently the thumbnail is identical to the after asset.
+   */
+  thumbnail?: WorkflowListResponse.Thumbnail;
+
+  /**
+   * The UI configuration for the workflow. This is managed by scenario webapp.
+   */
+  uiConfig?: WorkflowListResponse.UiConfig;
+}
+
+export namespace WorkflowListResponse {
+  export interface Flow {
     /**
-     * Current lifecycle status (draft, ready, deleted).
+     * The id of the node.
      */
-    status: 'deleted' | 'draft' | 'ready';
+    id: string;
 
     /**
-     * The tag set of the workflow.
+     * The type of the job for the node.
      */
-    tagSet: Array<string>;
+    type:
+      | 'custom-model'
+      | 'for-each'
+      | 'generate-prompt'
+      | 'list'
+      | 'logic'
+      | 'model'
+      | 'remove-background'
+      | 'transform'
+      | 'user-approval'
+      | 'workflow';
 
     /**
-     * ISO string
+     * 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.
      */
-    updatedAt: string;
+    count?: number;
 
     /**
-     * A representation of an asset after being processed by the workflow
+     * The nodes that this node depends on. Only available for nodes that have
+     * dependencies. Mainly used for user approval nodes.
      */
-    after?: Workflow.After;
+    dependsOn?: Array<string>;
 
     /**
-     * A representation of an asset before being processed by the workflow
+     * 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.
      */
-    before?: Workflow.Before;
+    includeOutputsInWorkflowJob?: true;
 
     /**
-     * Embedding is a map of embedding version into embedding date
+     * The inputs of the node.
      */
-    embedding?: unknown;
+    inputs?: Array<Flow.Input>;
 
     /**
-     * Whether the workflow is locked. Locked workflows cannot be modified or deleted
-     * except by the author or a project admin.
+     * 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.
      */
-    isLocked?: boolean;
-
-    lastIndexedAt?: string;
+    items?: Array<string>;
 
     /**
-     * The type of indexing operation to perform in MeiliSearch
+     * Zero-based index of the iteration this node copy belongs to. Set on
+     * dynamically-created copies of loop body nodes.
      */
-    lastIndexingType?: 'CREATE' | 'DELETE' | 'UPDATE';
+    iterationIndex?: number;
 
     /**
-     * Timestamp when the workflow flow was last saved as a Ready (App) snapshot. Used
-     * to compute the WorkflowNodes snapshot key. Only set for workflows that have been
-     * in the Ready state.
+     * The logic of the node. Only available for logic nodes.
      */
-    lastReadyFlowUpdatedAt?: string;
+    logic?: Flow.Logic;
 
     /**
-     * ISO string timestamp when lock state was last changed.
+     * The type of the logic for the node. Only available for logic nodes.
      */
-    lockedStateChangedAt?: string;
+    logicType?: 'if-else';
 
     /**
-     * UserId of the user who last changed the lock state.
+     * 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.
      */
-    lockedStateChangedBy?: string;
+    loopBodyNodeIds?: Array<string>;
 
     /**
-     * Asset kinds produced by this workflow (if specified).
+     * ID of the ForEach node that spawned this iteration copy. Set on
+     * dynamically-created copies of loop body nodes.
      */
-    outputAssetKinds?: Array<'3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video'>;
+    loopNodeId?: string;
 
     /**
-     * Currently the thumbnail is identical to the after asset.
+     * The model id for the node. Mainly used for custom model tasks.
      */
-    thumbnail?: Workflow.Thumbnail;
+    modelId?: string;
 
     /**
-     * The UI configuration for the workflow. This is managed by scenario webapp.
+     * The workflow id for the node. Mainly used for workflow tasks.
      */
-    uiConfig?: Workflow.UiConfig;
+    workflowId?: string;
   }
 
-  export namespace Workflow {
-    export interface Flow {
+  export namespace Flow {
+    /**
+     * This is used to run the flow.
+     */
+    export interface Input {
       /**
-       * The id of the node.
+       * The name that must be user to call the model through the API
        */
-      id: string;
+      name: string;
 
       /**
-       * The type of the job for the node.
+       * The data type of the input
        */
       type:
-        | 'custom-model'
-        | 'for-each'
-        | 'generate-prompt'
-        | 'list'
-        | 'logic'
+        | 'boolean'
+        | 'file'
+        | 'file_array'
+        | 'inputs_array'
         | 'model'
-        | 'remove-background'
-        | 'transform'
-        | 'user-approval'
-        | 'workflow';
+        | 'model_array'
+        | 'number'
+        | 'number_array'
+        | 'string'
+        | 'string_array';
 
       /**
-       * 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.
+       * 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.
        */
-      count?: number;
+      allowedValues?: Array<unknown>;
 
       /**
-       * The nodes that this node depends on. Only available for nodes that have
-       * dependencies. Mainly used for user approval nodes.
+       * Specifies the background behavior for the input. Only available for \`file\` and
+       * \`file_array\` input types with kind \`image\`.
        */
-      dependsOn?: Array<string>;
+      backgroundBehavior?: 'opaque' | 'transparent';
 
       /**
-       * 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.
+       * Whether the input is a color or not. Only available for \`string\` input type.
        */
-      includeOutputsInWorkflowJob?: true;
+      color?: boolean;
 
       /**
-       * The inputs of the node.
+       * Whether this input affects the model's cost calculation
        */
-      inputs?: Array<Flow.Input>;
+      costImpact?: boolean;
 
       /**
-       * 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.
+       * The default value for the input
        */
-      items?: Array<string>;
+      default?: unknown;
 
       /**
-       * Zero-based index of the iteration this node copy belongs to. Set on
-       * dynamically-created copies of loop body nodes.
+       * Help text displayed in the UI to provide additional information about the input
        */
-      iterationIndex?: number;
+      description?: string;
 
       /**
-       * The logic of the node. Only available for logic nodes.
+       * Used to visually group inputs together in the UI. Inputs with the same group
+       * value appear consecutively in the UI.
        */
-      logic?: Flow.Logic;
+      group?: string;
 
       /**
-       * The type of the logic for the node. Only available for logic nodes.
+       * Hint text displayed in the UI as a tooltip to guide the user
        */
-      logicType?: 'if-else';
+      hint?: string;
 
       /**
-       * 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.
+       * 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.
        */
-      loopBodyNodeIds?: Array<string>;
+      inputs?: Array<{ [key: string]: unknown }>;
 
       /**
-       * ID of the ForEach node that spawned this iteration copy. Set on
-       * dynamically-created copies of loop body nodes.
+       * 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.
        */
-      loopNodeId?: string;
+      items?: Array<Array<Input.Item>>;
 
       /**
-       * The model id for the node. Mainly used for custom model tasks.
+       * 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
        */
-      modelId?: string;
+      kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
 
       /**
-       * The workflow id for the node. Mainly used for workflow tasks.
+       * The label displayed in the UI for this input
        */
-      workflowId?: string;
+      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 length for \`string\` inputs. Also applies to each item in
+       * \`string_array\`.
+       */
+      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 inputs. Also applies to each item in
+       * \`string_array\`.
+       */
+      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'
+        | 'sd-1_5'
+        | 'sd-1_5-composition'
+        | 'sd-1_5-lora'
+        | 'sd-xl'
+        | 'sd-xl-composition'
+        | 'sd-xl-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
+       * - \`conditionalValues\`: Input is required when another input has a specific
+       *   value
+       *
+       * 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 Flow {
+    export namespace Input {
       /**
-       * This is used to run the flow.
+       * A sub-input within an inputs_array item. Same as NodeInput but without the
+       * recursive items field.
        */
-      export interface Input {
+      export interface Item {
         /**
          * The name that must be user to call the model through the API
          */
@@ -4321,13 +4545,6 @@ export namespace WorkflowListResponse {
          */
         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
@@ -4449,7 +4666,7 @@ export namespace WorkflowListResponse {
          * The reference to another input or output of the same workflow. Must have at
          * least one of node or conditional.
          */
-        ref?: Input.Ref;
+        ref?: Item.Ref;
 
         /**
          * Set of rules that describes when this input is required:
@@ -4463,7 +4680,7 @@ export namespace WorkflowListResponse {
          *
          * By default, the input is not required.
          */
-        required?: Input.Required;
+        required?: Item.Required;
 
         /**
          * The step increment for numeric inputs. Only available for \`number\` input type.
@@ -4477,842 +4694,615 @@ export namespace WorkflowListResponse {
         value?: unknown;
       }
 
-      export namespace Input {
+      export namespace Item {
         /**
-         * A sub-input within an inputs_array item. Same as NodeInput but without the
-         * recursive items field.
+         * The reference to another input or output of the same workflow. Must have at
+         * least one of node or conditional.
          */
-        export interface Item {
-          /**
-           * The name that must be user to call the model through the API
-           */
-          name: string;
-
+        export interface Ref {
           /**
-           * The data type of the input
+           * 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.
            */
-          type:
-            | 'boolean'
-            | 'file'
-            | 'file_array'
-            | 'inputs_array'
-            | 'model'
-            | 'model_array'
-            | 'number'
-            | 'number_array'
-            | 'string'
-            | 'string_array';
+          conditional?: Array<string>;
 
           /**
-           * 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.
+           * This is the desired node output value if ref is an if/else node.
            */
-          allowedValues?: Array<unknown>;
+          equal?: string;
 
           /**
-           * Specifies the background behavior for the input. Only available for \`file\` and
-           * \`file_array\` input types with kind \`image\`.
+           * 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'.
            */
-          backgroundBehavior?: 'opaque' | 'transparent';
+          name?: string;
 
           /**
-           * Whether the input is a color or not. Only available for \`string\` input type.
+           * The node id or 'workflow' if the source is a workflow input.
            */
-          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;
+          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
+         * - \`conditionalValues\`: Input is required when another input has a specific
+         *   value
+         *
+         * By default, the input is not required.
+         */
+        export interface Required {
           /**
-           * Used to visually group inputs together in the UI. Inputs with the same group
-           * value appear consecutively in the UI.
+           * Whether the input is always required
            */
-          group?: string;
+          always?: boolean;
 
           /**
-           * Hint text displayed in the UI as a tooltip to guide the user
+           * 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
            */
-          hint?: string;
+          conditionalValues?: unknown;
 
           /**
-           * 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.
+           * 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
            */
-          inputs?: Array<{ [key: string]: unknown }>;
+          ifDefined?: 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
+           * 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
            */
-          kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
+          ifNotDefined?: unknown;
+        }
+      }
 
-          /**
-           * The label displayed in the UI for this input
-           */
-          label?: string;
+      /**
+       * 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>;
 
-          /**
-           * The name of the file input field to use as the mask source
-           */
-          maskFrom?: string;
+        /**
+         * This is the desired node output value if ref is an if/else node.
+         */
+        equal?: string;
 
-          /**
-           * The maximum allowed value. Only available for \`number\` and \`array\` input
-           * types.
-           */
-          max?: number;
+        /**
+         * 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 maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
-           */
-          maxLength?: number;
+        /**
+         * The node id or 'workflow' if the source is a workflow input.
+         */
+        node?: string;
+      }
 
-          /**
-           * 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;
+      /**
+       * 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
+       * - \`conditionalValues\`: Input is required when another input has a specific
+       *   value
+       *
+       * By default, the input is not required.
+       */
+      export interface Required {
+        /**
+         * Whether the input is always required
+         */
+        always?: boolean;
 
-          /**
-           * The minimum allowed value. Only available for \`number\` and array input types.
-           */
-          min?: number;
+        /**
+         * 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
+         */
+        conditionalValues?: unknown;
 
-          /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
-           */
-          minLength?: number;
+        /**
+         * 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;
 
-          /**
-           * 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'
-            | 'sd-1_5'
-            | 'sd-1_5-composition'
-            | 'sd-1_5-lora'
-            | 'sd-xl'
-            | 'sd-xl-composition'
-            | 'sd-xl-lora'
-            | 'zimage-de-turbo-lora'
-            | 'zimage-lora'
-            | 'zimage-turbo-lora'
-          >;
+        /**
+         * 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;
+      }
+    }
 
-          /**
-           * 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;
+    /**
+     * 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>;
 
-          /**
-           * Placeholder text for the input. Only available for 'string' input type.
-           */
-          placeholder?: 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;
 
-          /**
-           * 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;
+      /**
+       * The transform of the logic. Only available for transform nodes.
+       */
+      transform?: string;
+    }
 
-          /**
-           * Whether the input is used with prompt spark. Only available for \`string\` input
-           * type.
-           */
-          promptSpark?: boolean;
+    export namespace Logic {
+      export interface Case {
+        condition: string;
 
-          /**
-           * The reference to another input or output of the same workflow. Must have at
-           * least one of node or conditional.
-           */
-          ref?: Item.Ref;
+        value: 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
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
-           *
-           * By default, the input is not required.
-           */
-          required?: Item.Required;
+  /**
+   * Defines the input parameters for a model. Use this to understand the available
+   * input parameters for a given `modelId` when calling
+   * `POST /generate/custom/{modelId}`. See {@link
+   * https://docs.scenario.com/docs/video-generation} for examples.
+   */
+  export interface Input {
+    /**
+     * The name that must be user to call the model through the API
+     */
+    name: string;
 
-          /**
-           * The step increment for numeric inputs. Only available for \`number\` input type.
-           */
-          step?: number;
+    /**
+     * The data type of the input
+     */
+    type:
+      | 'boolean'
+      | 'file'
+      | 'file_array'
+      | 'inputs_array'
+      | 'model'
+      | 'model_array'
+      | 'number'
+      | 'number_array'
+      | 'string'
+      | 'string_array';
 
-          /**
-           * 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;
-        }
+    /**
+     * 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>;
 
-        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>;
+    /**
+     * Specifies the background behavior for the input. Only available for \`file\` and
+     * \`file_array\` input types with kind \`image\`.
+     */
+    backgroundBehavior?: 'opaque' | 'transparent';
 
-            /**
-             * This is the desired node output value if ref is an if/else node.
-             */
-            equal?: string;
+    /**
+     * Whether the input is a color or not. Only available for \`string\` input type.
+     */
+    color?: boolean;
 
-            /**
-             * 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;
+    /**
+     * Whether this input affects the model's cost calculation
+     */
+    costImpact?: boolean;
 
-            /**
-             * The node id or 'workflow' if the source is a workflow input.
-             */
-            node?: string;
-          }
+    /**
+     * The default value for the input
+     */
+    default?: unknown;
 
-          /**
-           * 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
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
-           *
-           * By default, the input is not required.
-           */
-          export interface Required {
-            /**
-             * Whether the input is always required
-             */
-            always?: boolean;
+    /**
+     * Help text displayed in the UI to provide additional information about the input
+     */
+    description?: string;
 
-            /**
-             * 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
-             */
-            conditionalValues?: unknown;
+    /**
+     * Used to visually group inputs together in the UI. Inputs with the same group
+     * value appear consecutively in the UI.
+     */
+    group?: string;
 
-            /**
-             * 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;
+    /**
+     * Hint text displayed in the UI as a tooltip to guide the user
+     */
+    hint?: string;
 
-            /**
-             * 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;
-          }
-        }
+    /**
+     * 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 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>;
+    /**
+     * 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
+     */
+    kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
 
-          /**
-           * This is the desired node output value if ref is an if/else node.
-           */
-          equal?: string;
+    /**
+     * The label displayed in the UI for this input
+     */
+    label?: 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 name of the file input field to use as the mask source
+     */
+    maskFrom?: string;
 
-          /**
-           * The node id or 'workflow' if the source is a workflow input.
-           */
-          node?: string;
-        }
+    /**
+     * The maximum allowed value. Only available for \`number\` and \`array\` input
+     * types.
+     */
+    max?: number;
 
-        /**
-         * 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
-         * - \`conditionalValues\`: Input is required when another input has a specific
-         *   value
-         *
-         * By default, the input is not required.
-         */
-        export interface Required {
-          /**
-           * Whether the input is always required
-           */
-          always?: boolean;
+    /**
+     * The maximum allowed length for \`string\` inputs. Also applies to each item in
+     * \`string_array\`.
+     */
+    maxLength?: number;
 
-          /**
-           * 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
-           */
-          conditionalValues?: unknown;
+    /**
+     * 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;
 
-          /**
-           * 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;
-        }
-      }
-
-      /**
-       * The logic of the node. Only available for logic nodes.
-       */
-      export interface Logic {
-        /**
-         * The cases of the logic. Only available for if/else nodes.
-         */
-        cases?: Array<Logic.Case>;
-
-        /**
-         * The default case of the logic. Contains the id/output of the node to execute if
-         * no case is matched. Only available for if/else nodes.
-         */
-        default?: string;
-
-        /**
-         * The transform of the logic. Only available for transform nodes.
-         */
-        transform?: string;
-      }
-
-      export namespace Logic {
-        export interface Case {
-          condition: string;
-
-          value: string;
-        }
-      }
-    }
+    /**
+     * The minimum allowed value. Only available for \`number\` and array input types.
+     */
+    min?: number;
 
     /**
-     * Defines the input parameters for a model. Use this to understand the available
-     * input parameters for a given `modelId` when calling
-     * `POST /generate/custom/{modelId}`. See {@link
-     * https://docs.scenario.com/docs/video-generation} for examples.
+     * The minimum allowed length for string inputs. Also applies to each item in
+     * \`string_array\`.
      */
-    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 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
-       */
-      kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | '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 length for \`string\` inputs. Also applies to each item in
-       * \`string_array\`.
-       */
-      maxLength?: number;
+    minLength?: 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 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'
+      | 'sd-1_5'
+      | 'sd-1_5-composition'
+      | 'sd-1_5-lora'
+      | 'sd-xl'
+      | 'sd-xl-composition'
+      | 'sd-xl-lora'
+      | 'zimage-de-turbo-lora'
+      | 'zimage-lora'
+      | 'zimage-turbo-lora'
+    >;
 
-      /**
-       * The minimum allowed value. Only available for \`number\` and array input types.
-       */
-      min?: number;
+    /**
+     * 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;
 
-      /**
-       * The minimum allowed length for string inputs. Also applies to each item in
-       * \`string_array\`.
-       */
-      minLength?: number;
+    /**
+     * Placeholder text for the input. Only available for 'string' input type.
+     */
+    placeholder?: string;
 
-      /**
-       * 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'
-        | 'sd-1_5'
-        | 'sd-1_5-composition'
-        | 'sd-1_5-lora'
-        | 'sd-xl'
-        | 'sd-xl-composition'
-        | 'sd-xl-lora'
-        | 'zimage-de-turbo-lora'
-        | 'zimage-lora'
-        | 'zimage-turbo-lora'
-      >;
+    /**
+     * 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 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;
+    /**
+     * Whether the input is used with prompt spark. Only available for \`string\` input
+     * type.
+     */
+    promptSpark?: boolean;
 
-      /**
-       * Placeholder text for the input. Only available for 'string' input type.
-       */
-      placeholder?: 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
+     * - \`conditionalValues\`: Input is required when another input has a specific
+     *   value
+     *
+     * By default, the input is not required.
+     */
+    required?: Input.Required;
 
-      /**
-       * 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;
+    /**
+     * The step increment for numeric inputs. Only available for \`number\` input type.
+     */
+    step?: number;
+  }
 
+  export namespace Input {
+    /**
+     * 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
+     * - \`conditionalValues\`: Input is required when another input has a specific
+     *   value
+     *
+     * By default, the input is not required.
+     */
+    export interface Required {
       /**
-       * Whether the input is used with prompt spark. Only available for \`string\` input
-       * type.
+       * Whether the input is always required
        */
-      promptSpark?: boolean;
+      always?: boolean;
 
       /**
-       * 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
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * Makes this input required when another input has a specific value:
        *
-       * By default, the input is not required.
+       * - Key: name of the input to check
+       * - Value: operation and allowed values that trigger the requirement
        */
-      required?: Input.Required;
+      conditionalValues?: unknown;
 
       /**
-       * The step increment for numeric inputs. Only available for \`number\` input type.
+       * 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
        */
-      step?: number;
-    }
+      ifDefined?: unknown;
 
-    export namespace Input {
       /**
-       * 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
-       * - \`conditionalValues\`: Input is required when another input has a specific
-       *   value
+       * Makes this input required when another input is not defined:
        *
-       * By default, the input is not required.
+       * - Key: name of the input that must be undefined
+       * - Value: message to display when this input is required
        */
-      export interface Required {
-        /**
-         * Whether the input is always required
-         */
-        always?: boolean;
+      ifNotDefined?: unknown;
+    }
+  }
 
-        /**
-         * 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
-         */
-        conditionalValues?: unknown;
+  /**
+   * A representation of an asset after being processed by the workflow
+   */
+  export interface After {
+    /**
+     * The AssetId of the image used as a thumbnail for your model (example:
+     * "asset_GTrL3mq4SXWyMxkOHRxlpw")
+     */
+    assetId: string;
 
-        /**
-         * 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;
+    /**
+     * The url of the image used as a thumbnail for your model
+     */
+    url: string;
+  }
 
-        /**
-         * 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;
-      }
-    }
+  /**
+   * A representation of an asset before being processed by the workflow
+   */
+  export interface Before {
+    /**
+     * The AssetId of the image used as a thumbnail for your model (example:
+     * "asset_GTrL3mq4SXWyMxkOHRxlpw")
+     */
+    assetId: string;
 
     /**
-     * A representation of an asset after being processed by the workflow
+     * The url of the image used as a thumbnail for your model
      */
-    export interface After {
-      /**
-       * The AssetId of the image used as a thumbnail for your model (example:
-       * "asset_GTrL3mq4SXWyMxkOHRxlpw")
-       */
-      assetId: string;
+    url: string;
+  }
 
-      /**
-       * The url of the image used as a thumbnail for your model
-       */
-      url: string;
-    }
+  /**
+   * Currently the thumbnail is identical to the after asset.
+   */
+  export interface Thumbnail {
+    assetId: string;
+
+    url: string;
+  }
 
+  /**
+   * The UI configuration for the workflow. This is managed by scenario webapp.
+   */
+  export interface UiConfig {
     /**
-     * A representation of an asset before being processed by the workflow
+     * Configuration for the input properties
      */
-    export interface Before {
-      /**
-       * The AssetId of the image used as a thumbnail for your model (example:
-       * "asset_GTrL3mq4SXWyMxkOHRxlpw")
-       */
-      assetId: string;
+    inputProperties?: { [key: string]: UiConfig.InputProperties };
 
-      /**
-       * The url of the image used as a thumbnail for your model
-       */
-      url: string;
-    }
+    /**
+     * Configuration for the loras component
+     */
+    lorasComponent?: UiConfig.LorasComponent;
 
     /**
-     * Currently the thumbnail is identical to the after asset.
+     * Configuration for the presets
      */
-    export interface Thumbnail {
-      assetId: string;
+    presets?: Array<UiConfig.Preset>;
 
-      url: string;
+    /**
+     * Configuration for the resolution component
+     */
+    resolutionComponent?: UiConfig.ResolutionComponent;
+
+    /**
+     * Configuration for the selects
+     */
+    selects?: { [key: string]: unknown };
+
+    /**
+     * Configuration for the trigger generate button
+     */
+    triggerGenerate?: UiConfig.TriggerGenerate;
+  }
+
+  export namespace UiConfig {
+    export interface InputProperties {
+      collapsed?: boolean;
     }
 
     /**
-     * The UI configuration for the workflow. This is managed by scenario webapp.
+     * Configuration for the loras component
      */
-    export interface UiConfig {
+    export interface LorasComponent {
       /**
-       * Configuration for the input properties
+       * The label of the component
        */
-      inputProperties?: { [key: string]: UiConfig.InputProperties };
+      label: string;
 
       /**
-       * Configuration for the loras component
+       * The input name of the model (model_array)
        */
-      lorasComponent?: UiConfig.LorasComponent;
+      modelInput: string;
 
       /**
-       * Configuration for the presets
+       * The input name of the scale (number_array)
        */
-      presets?: Array<UiConfig.Preset>;
+      scaleInput: string;
 
       /**
-       * Configuration for the resolution component
+       * 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
        */
-      resolutionComponent?: UiConfig.ResolutionComponent;
+      modelIdInput?: string;
+    }
 
+    export interface Preset {
+      fields: Array<string>;
+
+      presets: unknown;
+    }
+
+    /**
+     * Configuration for the resolution component
+     */
+    export interface ResolutionComponent {
       /**
-       * Configuration for the selects
+       * The input name of the height
        */
-      selects?: { [key: string]: unknown };
+      heightInput: string;
 
       /**
-       * Configuration for the trigger generate button
+       * The label of the component
        */
-      triggerGenerate?: UiConfig.TriggerGenerate;
-    }
-
-    export namespace UiConfig {
-      export interface InputProperties {
-        collapsed?: boolean;
-      }
+      label: string;
 
       /**
-       * Configuration for the loras component
+       * The resolution presets
        */
-      export interface LorasComponent {
-        /**
-         * The label of the component
-         */
-        label: string;
-
-        /**
-         * The input name of the model (model_array)
-         */
-        modelInput: 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 Preset {
-        fields: Array<string>;
-
-        presets: unknown;
-      }
+      presets: Array<ResolutionComponent.Preset>;
 
       /**
-       * Configuration for the resolution component
+       * The input name of the width
        */
-      export interface ResolutionComponent {
-        /**
-         * The input name of the height
-         */
-        heightInput: string;
+      widthInput: string;
+    }
 
-        /**
-         * The label of the component
-         */
-        label: string;
+    export namespace ResolutionComponent {
+      export interface Preset {
+        height: number;
 
-        /**
-         * The resolution presets
-         */
-        presets: Array<ResolutionComponent.Preset>;
+        label: string;
 
-        /**
-         * The input name of the width
-         */
-        widthInput: string;
+        width: number;
       }
+    }
 
-      export namespace ResolutionComponent {
-        export interface Preset {
-          height: number;
-
-          label: string;
-
-          width: number;
-        }
-      }
+    /**
+     * Configuration for the trigger generate button
+     */
+    export interface TriggerGenerate {
+      label: string;
 
       /**
-       * Configuration for the trigger generate button
+       * The 'name' of the input where the trigger generate button will be displayed
+       * (after the input). Do not specify both position and after.
        */
-      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;
+      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';
-      }
+      /**
+       * 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';
     }
   }
 }
@@ -9614,18 +9604,13 @@ export namespace WorkflowUpdateParams {
   }
 }
 
-export interface WorkflowListParams {
+export interface WorkflowListParams extends WorkflowsCursorParams {
   /**
    * The number of items to return in the response. The default value is 10, maximum
    * value is 200, minimum value is 1
    */
   pageSize?: number;
 
-  /**
-   * A token you received in a previous request to query the next page of items
-   */
-  paginationToken?: string;
-
   /**
    * The privacy of the workflows to return. The default value is `private`, possible
    * values are `private`, `public` and `unlisted`. Default value is `private`.
@@ -9681,6 +9666,7 @@ export declare namespace Workflows {
     type WorkflowApproveUserResponse as WorkflowApproveUserResponse,
     type WorkflowGetTagsResponse as WorkflowGetTagsResponse,
     type WorkflowRunResponse as WorkflowRunResponse,
+    type WorkflowListResponsesWorkflowsCursor as WorkflowListResponsesWorkflowsCursor,
     type WorkflowCreateParams as WorkflowCreateParams,
     type WorkflowUpdateParams as WorkflowUpdateParams,
     type WorkflowListParams as WorkflowListParams,