@scenario-labs/sdk 2.7.0 → 3.0.0

package/src/resources/workflows.ts

@@ -10,15 +10,20 @@ export class Workflows extends APIResource {
   /**
    * Create workflow
    */
-  create(body: WorkflowCreateParams, options?: RequestOptions): APIPromise<WorkflowCreateResponse> {
-    return this._client.post('/workflows', { body, ...options });
+  create(params: WorkflowCreateParams, options?: RequestOptions): APIPromise<WorkflowCreateResponse> {
+    const { projectId, ...body } = params;
+    return this._client.post('/workflows', { query: { projectId }, body, ...options });
   }
 
   /**
    * Get workflow by ID
    */
-  retrieve(workflowID: string, options?: RequestOptions): APIPromise<WorkflowRetrieveResponse> {
-    return this._client.get(path`/workflows/${workflowID}`, options);
+  retrieve(
+    workflowID: string,
+    query: WorkflowRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<WorkflowRetrieveResponse> {
+    return this._client.get(path`/workflows/${workflowID}`, { query, ...options });
   }
 
   /**
@@ -26,10 +31,11 @@ export class Workflows extends APIResource {
    */
   update(
     workflowID: string,
-    body: WorkflowUpdateParams,
+    params: WorkflowUpdateParams,
     options?: RequestOptions,
   ): APIPromise<WorkflowUpdateResponse> {
-    return this._client.put(path`/workflows/${workflowID}`, { body, ...options });
+    const { projectId, ...body } = params;
+    return this._client.put(path`/workflows/${workflowID}`, { query: { projectId }, body, ...options });
   }
 
   /**
@@ -48,8 +54,13 @@ export class Workflows extends APIResource {
   /**
    * Delete workflow
    */
-  delete(workflowID: string, options?: RequestOptions): APIPromise<unknown> {
-    return this._client.delete(path`/workflows/${workflowID}`, options);
+  delete(
+    workflowID: string,
+    params: WorkflowDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<unknown> {
+    const { projectId } = params ?? {};
+    return this._client.delete(path`/workflows/${workflowID}`, { query: { projectId }, ...options });
   }
 
   /**
@@ -71,9 +82,9 @@ export class Workflows extends APIResource {
     params: WorkflowRunParams,
     options?: RequestOptions,
   ): APIPromise<WorkflowRunResponse> {
-    const { body, dryRun } = params;
+    const { body, dryRun, projectId } = params;
     return this._client.put(path`/workflows/${workflowID}/run`, {
-      query: { dryRun },
+      query: { dryRun, projectId },
       body: body,
       ...options,
     });
@@ -87,10 +98,15 @@ export class Workflows extends APIResource {
    */
   userApproval(
     workflowID: string,
-    body: WorkflowUserApprovalParams,
+    params: WorkflowUserApprovalParams,
     options?: RequestOptions,
   ): APIPromise<WorkflowUserApprovalResponse> {
-    return this._client.put(path`/workflows/${workflowID}/user-approval`, { body, ...options });
+    const { projectId, ...body } = params;
+    return this._client.put(path`/workflows/${workflowID}/user-approval`, {
+      query: { projectId },
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -137,6 +153,12 @@ export namespace WorkflowCreateResponse {
      */
     flow: Array<Workflow.Flow>;
 
+    /**
+     * Whether the workflow has a non-empty flow. Present even when `flow` itself is
+     * not, so an empty workflow can be told apart from a populated one.
+     */
+    hasFlow: boolean;
+
     /**
      * The inputs of the workflow.
      */
@@ -1445,6 +1467,12 @@ export namespace WorkflowRetrieveResponse {
      */
     flow: Array<Workflow.Flow>;
 
+    /**
+     * Whether the workflow has a non-empty flow. Present even when `flow` itself is
+     * not, so an empty workflow can be told apart from a populated one.
+     */
+    hasFlow: boolean;
+
     /**
      * The inputs of the workflow.
      */
@@ -2753,6 +2781,12 @@ export namespace WorkflowUpdateResponse {
      */
     flow: Array<Workflow.Flow>;
 
+    /**
+     * Whether the workflow has a non-empty flow. Present even when `flow` itself is
+     * not, so an empty workflow can be told apart from a populated one.
+     */
+    hasFlow: boolean;
+
     /**
      * The inputs of the workflow.
      */
@@ -4025,6 +4059,10 @@ export namespace WorkflowUpdateResponse {
   }
 }
 
+/**
+ * A workflow as returned by `GET /v1/workflows`, where the caller can trade the
+ * two heaviest fields away to keep a large page under the response size limit.
+ */
 export interface WorkflowListResponse {
   /**
    * Unique identifier of the workflow.
@@ -4047,14 +4085,10 @@ export interface WorkflowListResponse {
   description: string;
 
   /**
-   * The UI data about the workflow. This is managed by scenario webapp.
-   */
-  editorInfo: { [key: string]: unknown };
-
-  /**
-   * The flow of the workflow.
+   * Whether the workflow has a non-empty flow. Present even when `flow` itself is
+   * not, so an empty workflow can be told apart from a populated one.
    */
-  flow: Array<WorkflowListResponse.Flow>;
+  hasFlow: boolean;
 
   /**
    * The inputs of the workflow.
@@ -4106,11 +4140,23 @@ export interface WorkflowListResponse {
    */
   before?: WorkflowListResponse.Before;
 
+  /**
+   * The UI data about the workflow. This is managed by scenario webapp. Omitted when
+   * the listing is requested with `full=false`.
+   */
+  editorInfo?: { [key: string]: unknown };
+
   /**
    * Embedding is a map of embedding version into embedding date
    */
   embedding?: unknown;
 
+  /**
+   * The flow of the workflow. Omitted when the listing is requested with
+   * `full=false`; read `hasFlow` to know whether there is a flow to fetch.
+   */
+  flow?: Array<WorkflowListResponse.Flow>;
+
   /**
    * Whether the workflow is locked. Locked workflows cannot be modified or deleted
    * except by the author or a project admin.
@@ -4147,236 +4193,531 @@ export interface WorkflowListResponse {
   outputAssetKinds?: Array<'3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video'>;
 
   /**
-   * Currently the thumbnail is identical to the after asset.
+   * Optional thumbnail asset for listing/display. Currently the thumbnail is
+   * identical to the after asset.
    */
   thumbnail?: WorkflowListResponse.Thumbnail;
 
   /**
-   * The UI configuration for the workflow. This is managed by scenario webapp.
+   * UI configuration for custom workflows input display configuration. The UI
+   * configuration for the workflow. This is managed by scenario webapp.
    */
   uiConfig?: WorkflowListResponse.UiConfig;
 }
 
 export namespace WorkflowListResponse {
-  export interface Flow {
+  /**
+   * 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/get-started/generation/video-generation} for examples.
+   */
+  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 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
      */
-    loopNodeId?: string;
+    kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
     /**
-     * The model id for the node. Mainly used for custom model tasks.
+     * The label displayed in the UI for this input
      */
-    modelId?: string;
+    label?: string;
 
     /**
-     * The workflow id for the node. Mainly used for workflow tasks.
+     * The name of the file input field to use as the mask source
      */
-    workflowId?: string;
-  }
+    maskFrom?: string;
 
-  export namespace Flow {
     /**
-     * This is used to run the flow.
+     * The maximum allowed value. Only available for \`number\` and \`array\` input
+     * types.
      */
-    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';
+    max?: number;
 
-      /**
-       * 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>;
+    /**
+     * 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;
 
-      /**
-       * Specifies the background behavior for the input. Only available for \`file\` and
-       * \`file_array\` input types with kind \`image\`.
-       */
-      backgroundBehavior?: 'opaque' | 'transparent';
+    /**
+     * The maximum allowed length for \`string\` inputs. Also applies to each item in
+     * \`string_array\`.
+     */
+    maxLength?: number;
 
-      /**
-       * Whether the input is a color or not. Only available for \`string\` input type.
-       */
-      color?: boolean;
+    /**
+     * 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;
 
-      /**
-       * Whether this input affects the model's cost calculation
-       */
-      costImpact?: boolean;
+    /**
+     * The minimum allowed value. Only available for \`number\` and array input types.
+     */
+    min?: number;
 
-      /**
-       * The default value for the input
-       */
-      default?: unknown;
+    /**
+     * The minimum allowed length for string inputs. Also applies to each item in
+     * \`string_array\`.
+     */
+    minLength?: number;
 
-      /**
-       * Help text displayed in the UI to provide additional information about the input
-       */
-      description?: 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'
+      | 'zimage-de-turbo-lora'
+      | 'zimage-lora'
+      | 'zimage-turbo-lora'
+    >;
 
-      /**
-       * Used to visually group inputs together in the UI. Inputs with the same group
-       * value appear consecutively in the UI.
-       */
-      group?: string;
+    /**
+     * 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;
 
-      /**
-       * Hint text displayed in the UI as a tooltip to guide the user
-       */
-      hint?: string;
+    /**
+     * 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;
+
+    /**
+     * 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;
+  }
 
+  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 {
       /**
-       * 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.
+       * Whether the input is always required
        */
-      inputs?: Array<{ [key: string]: unknown }>;
+      always?: boolean;
 
       /**
-       * 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.
+       * 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
        */
-      items?: Array<Array<Input.Item>>;
+      conditionalValues?: 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 defined:
+       *
+       * - Key: name of the input that must be defined
+       * - Value: message to display when this input is required
        */
-      kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
+      ifDefined?: unknown;
 
       /**
-       * The label displayed in the UI for this input
+       * 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
        */
-      label?: string;
+      ifNotDefined?: 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;
+
+    /**
+     * The url of the image used as a thumbnail for your model
+     */
+    url: string;
+  }
+
+  /**
+   * 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;
+
+    /**
+     * The url of the image used as a thumbnail for your model
+     */
+    url: string;
+  }
+
+  export interface Flow {
+    /**
+     * The id of the node.
+     */
+    id: string;
+
+    /**
+     * The type of the job for the node.
+     */
+    type:
+      | 'custom-model'
+      | 'for-each'
+      | 'generate-prompt'
+      | 'list'
+      | 'logic'
+      | 'model'
+      | 'remove-background'
+      | 'transform'
+      | 'user-approval'
+      | 'workflow';
+
+    /**
+     * Fixed number of iterations for a ForEach node. When set, the loop runs exactly
+     * `count` times regardless of array input. When not set, the loop iterates over
+     * 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.
+     */
+    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.
+     */
+    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;
+
+    /**
+     * 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 workflow id for the node. Mainly used for workflow tasks.
+     */
+    workflowId?: string;
+  }
+
+  export namespace Flow {
+    /**
+     * This is used to run the flow.
+     */
+    export interface Input {
       /**
-       * The name of the file input field to use as the mask source
+       * The name that must be user to call the model through the API
        */
-      maskFrom?: string;
+      name: string;
 
       /**
-       * The maximum allowed value. Only available for \`number\` and \`array\` input
-       * types.
+       * The data type of the input
        */
-      max?: number;
+      type:
+        | 'boolean'
+        | 'file'
+        | 'file_array'
+        | 'inputs_array'
+        | 'model'
+        | 'model_array'
+        | 'number'
+        | 'number_array'
+        | 'string'
+        | 'string_array';
 
       /**
-       * 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.
+       * 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.
        */
-      maxDuration?: number;
+      allowedValues?: Array<unknown>;
 
       /**
-       * The maximum allowed length for \`string\` inputs. Also applies to each item in
-       * \`string_array\`.
+       * Specifies the background behavior for the input. Only available for \`file\` and
+       * \`file_array\` input types with kind \`image\`.
        */
-      maxLength?: number;
+      backgroundBehavior?: 'opaque' | 'transparent';
 
       /**
-       * 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.
+       * 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
+       */
+      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\` 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;
 
@@ -4793,411 +5134,122 @@ export namespace WorkflowListResponse {
        * 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
-       * - \`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;
-
-        /**
-         * 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;
-
-        /**
-         * 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;
-      }
-    }
-  }
-
-  /**
-   * 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/get-started/generation/video-generation} for examples.
-   */
-  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' | '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\` 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'
-      | 'zimage-de-turbo-lora'
-      | 'zimage-lora'
-      | 'zimage-turbo-lora'
-    >;
+      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>;
 
-    /**
-     * 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;
+        /**
+         * This is the desired node output value if ref is an if/else node.
+         */
+        equal?: string;
 
-    /**
-     * Placeholder text for the input. Only available for 'string' input type.
-     */
-    placeholder?: 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;
 
-    /**
-     * 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 node id or 'workflow' if the source is a workflow input.
+         */
+        node?: string;
+      }
 
-    /**
-     * Whether the input is used with prompt spark. Only available for \`string\` input
-     * type.
-     */
-    promptSpark?: 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
+       *
+       * By default, the input is not required.
+       */
+      export interface Required {
+        /**
+         * Whether the input is always required
+         */
+        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
-     *
-     * By default, the input is not required.
-     */
-    required?: Input.Required;
+        /**
+         * 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 step increment for numeric inputs. Only available for \`number\` input type.
-     */
-    step?: 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;
+      }
+    }
 
-  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.
+     * The logic of the node. Only available for logic nodes.
      */
-    export interface Required {
-      /**
-       * Whether the input is always required
-       */
-      always?: boolean;
-
+    export interface Logic {
       /**
-       * 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
+       * The cases of the logic. Only available for if/else nodes.
        */
-      conditionalValues?: unknown;
+      cases?: Array<Logic.Case>;
 
       /**
-       * 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
+       * 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.
        */
-      ifDefined?: unknown;
+      default?: 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
+       * The transform of the logic. Only available for transform nodes.
        */
-      ifNotDefined?: unknown;
+      transform?: string;
     }
-  }
-
-  /**
-   * 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;
-
-    /**
-     * The url of the image used as a thumbnail for your model
-     */
-    url: string;
-  }
 
-  /**
-   * 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;
+    export namespace Logic {
+      export interface Case {
+        condition: string;
 
-    /**
-     * The url of the image used as a thumbnail for your model
-     */
-    url: string;
+        value: string;
+      }
+    }
   }
 
   /**
-   * Currently the thumbnail is identical to the after asset.
+   * Optional thumbnail asset for listing/display. Currently the thumbnail is
+   * identical to the after asset.
    */
   export interface Thumbnail {
+    __brand: 'AssetId';
+
     assetId: string;
 
     url: string;
   }
 
   /**
-   * The UI configuration for the workflow. This is managed by scenario webapp.
+   * UI configuration for custom workflows input display configuration. The UI
+   * configuration for the workflow. This is managed by scenario webapp.
    */
   export interface UiConfig {
     /**
@@ -6290,6 +6342,27 @@ export namespace WorkflowRunResponse {
 
       cuDiscount: number;
 
+      /**
+       * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
+       * top of the generation itself, such as `slop-detection`.
+       *
+       * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+       * values here.
+       *
+       * Two caveats when displaying it:
+       *
+       * - These are a remaining refundable balance, not a receipt: a job that failed or
+       *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+       *   still shows the main action's original charge.
+       * - `ip-detection` is part of the shape but is never populated today: that fee is
+       *   charged outside the job and reported once, as
+       *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+       *   it.
+       *
+       * Absent when the job paid for no add-on.
+       */
+      cuCostDetails?: Billing.CuCostDetails;
+
       /**
        * When true, the credits charged for this job are not automatically refunded if
        * the generation fails, because the model used does not support refund-on-failure.
@@ -6297,6 +6370,33 @@ export namespace WorkflowRunResponse {
        */
       disableRefund?: boolean;
     }
+
+    export namespace Billing {
+      /**
+       * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
+       * top of the generation itself, such as `slop-detection`.
+       *
+       * `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;
+
+        'slop-detection'?: number;
+      }
+    }
   }
 
   export interface Workflow {
@@ -6330,6 +6430,12 @@ export namespace WorkflowRunResponse {
      */
     flow: Array<Workflow.Flow>;
 
+    /**
+     * Whether the workflow has a non-empty flow. Present even when `flow` itself is
+     * not, so an empty workflow can be told apart from a populated one.
+     */
+    hasFlow: boolean;
+
     /**
      * The inputs of the workflow.
      */
@@ -8554,6 +8660,27 @@ export namespace WorkflowUserApprovalResponse {
 
       cuDiscount: number;
 
+      /**
+       * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
+       * top of the generation itself, such as `slop-detection`.
+       *
+       * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+       * values here.
+       *
+       * Two caveats when displaying it:
+       *
+       * - These are a remaining refundable balance, not a receipt: a job that failed or
+       *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+       *   still shows the main action's original charge.
+       * - `ip-detection` is part of the shape but is never populated today: that fee is
+       *   charged outside the job and reported once, as
+       *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+       *   it.
+       *
+       * Absent when the job paid for no add-on.
+       */
+      cuCostDetails?: Billing.CuCostDetails;
+
       /**
        * When true, the credits charged for this job are not automatically refunded if
        * the generation fails, because the model used does not support refund-on-failure.
@@ -8561,92 +8688,143 @@ export namespace WorkflowUserApprovalResponse {
        */
       disableRefund?: boolean;
     }
+
+    export namespace Billing {
+      /**
+       * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
+       * top of the generation itself, such as `slop-detection`.
+       *
+       * `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;
+
+        'slop-detection'?: number;
+      }
+    }
   }
 }
 
 export interface WorkflowCreateParams {
+  /**
+   * Body param
+   */
   description: string;
 
+  /**
+   * Body param
+   */
   name: string;
+
+  /**
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
+}
+
+export interface WorkflowRetrieveParams {
+  projectId?: unknown;
 }
 
 export interface WorkflowUpdateParams {
   /**
-   * The after asset of the workflow. Set to null to unset the after asset.
+   * Query param
+   */
+  projectId?: unknown;
+
+  /**
+   * Body param: The after asset of the workflow. Set to null to unset the after
+   * asset.
    */
   after?: string;
 
   /**
-   * The before asset of the workflow. Set to null to unset the before asset.
+   * Body param: The before asset of the workflow. Set to null to unset the before
+   * asset.
    */
   before?: string;
 
   /**
-   * Set to true to bypass the lock and save a locked workflow without unlocking it
-   * first. Only the author or a project admin can use this.
+   * Body param: Set to true to bypass the lock and save a locked workflow without
+   * unlocking it first. Only the author or a project admin can use this.
    */
   bypassLock?: boolean;
 
   /**
-   * The description of the workflow.
+   * Body param: The description of the workflow.
    */
   description?: string;
 
   /**
-   * The UI data about the workflow. This is managed by scenario webapp.
+   * Body param: The UI data about the workflow. This is managed by scenario webapp.
    */
   editorInfo?: { [key: string]: unknown };
 
   /**
-   * The flow of the workflow.
+   * Body param: The flow of the workflow.
    */
   flow?: Array<WorkflowUpdateParams.Flow>;
 
   /**
-   * The inputs of the workflow.
+   * Body param: The inputs of the workflow.
    */
   inputs?: Array<WorkflowUpdateParams.Input>;
 
   /**
-   * Set to true to lock the workflow, false to unlock. Only the author or a project
-   * admin can change this.
+   * Body param: Set to true to lock the workflow, false to unlock. Only the author
+   * or a project admin can change this.
    */
   isLocked?: boolean;
 
   /**
-   * The name of the workflow.
+   * Body param: The name of the workflow.
    */
   name?: string;
 
   /**
-   * The output asset kinds of the workflow.
+   * Body param: The output asset kinds of the workflow.
    */
   outputAssetKinds?: Array<'3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video'>;
 
   /**
-   * The privacy of the workflow.
+   * Body param: The privacy of the workflow.
    */
   privacy?: 'private' | 'public' | 'unlisted';
 
   /**
-   * A short description of the workflow.
+   * Body param: A short description of the workflow.
    *
    * Used for display in the App UI.
    */
   shortDescription?: string;
 
   /**
-   * The status of the workflow.
+   * Body param: The status of the workflow.
    */
   status?: 'draft' | 'ready';
 
   /**
-   * The tag set of the workflow.
+   * Body param: The tag set of the workflow.
    */
   tagSet?: Array<string>;
 
   /**
-   * The thumbnail asset of the workflow. Set to null to unset the thumbnail.
+   * Body param: The thumbnail asset of the workflow. Set to null to unset the
+   * thumbnail.
    */
   thumbnail?: string;
 }
@@ -9651,6 +9829,15 @@ export namespace WorkflowUpdateParams {
 }
 
 export interface WorkflowListParams extends WorkflowsCursorParams {
+  /**
+   * Whether to return the complete workflow (default `true`). Set it to `false` to
+   * omit `flow` and `editorInfo`, the two heaviest fields, and keep a large page
+   * under the response size limit; `hasFlow` then tells you which workflows have a
+   * flow to fetch from `GET /v1/workflows/{workflowId}`. Ignored for public
+   * listings, which never return either field.
+   */
+  full?: boolean;
+
   /**
    * The number of items to return in the response. The default value is 50, maximum
    * value is 100, minimum value is 1
@@ -9663,6 +9850,12 @@ export interface WorkflowListParams extends WorkflowsCursorParams {
    */
   privacy?: 'public' | 'private' | 'unlisted';
 
+  /**
+   * The projectId used for ownership resource management. Either to assert ownership
+   * or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
   /**
    * Sort direction applied to `updatedAt`: `asc` or `desc` (default `desc`). Public
    * listings are always ordered by `updatedAt`. Private listings honor it only when
@@ -9680,7 +9873,17 @@ export interface WorkflowListParams extends WorkflowsCursorParams {
   tags?: unknown;
 }
 
+export interface WorkflowDeleteParams {
+  projectId?: unknown;
+}
+
 export interface WorkflowGetTagsParams {
+  /**
+   * The projectId used for ownership resource management. Either to assert ownership
+   * or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
   status?: unknown;
 }
 
@@ -9695,44 +9898,59 @@ export interface WorkflowRunParams {
    * Query param
    */
   dryRun?: unknown;
+
+  /**
+   * Query param
+   */
+  projectId?: unknown;
 }
 
 export interface WorkflowUserApprovalParams {
   /**
-   * The ID of the user approval node to act on in the workflow
+   * Query param
+   */
+  projectId: unknown;
+
+  /**
+   * Body param: The ID of the user approval node to act on in the workflow
    */
   nodeId: string;
 
   /**
-   * The ID of the workflow job that contains the user approval node
+   * Body param: The ID of the workflow job that contains the user approval node
    */
   workflowJobId: string;
 
   /**
-   * Decision taken on the approval node. "approve" marks it Success and advances the
-   * workflow; "reject" marks it Rejected and either cancels the workflow or — if the
-   * node is inside a ForEach iteration — cascades to the loop. Defaults to "approve"
-   * for backward compatibility.
+   * Body param: Decision taken on the approval node. "approve" marks it Success and
+   * advances the workflow; "reject" marks it Rejected and either cancels the
+   * workflow or — if the node is inside a ForEach iteration — cascades to the loop.
+   * Defaults to "approve" for backward compatibility.
    */
   action?: 'approve' | 'reject';
 }
 
 export interface WorkflowApproveUserParams {
   /**
-   * The ID of the user approval node to act on in the workflow
+   * Query param
+   */
+  projectId: unknown;
+
+  /**
+   * Body param: The ID of the user approval node to act on in the workflow
    */
   nodeId: string;
 
   /**
-   * The ID of the workflow job that contains the user approval node
+   * Body param: The ID of the workflow job that contains the user approval node
    */
   workflowJobId: string;
 
   /**
-   * Decision taken on the approval node. "approve" marks it Success and advances the
-   * workflow; "reject" marks it Rejected and either cancels the workflow or — if the
-   * node is inside a ForEach iteration — cascades to the loop. Defaults to "approve"
-   * for backward compatibility.
+   * Body param: Decision taken on the approval node. "approve" marks it Success and
+   * advances the workflow; "reject" marks it Rejected and either cancels the
+   * workflow or — if the node is inside a ForEach iteration — cascades to the loop.
+   * Defaults to "approve" for backward compatibility.
    */
   action?: 'approve' | 'reject';
 }
@@ -9749,8 +9967,10 @@ export declare namespace Workflows {
     type WorkflowUserApprovalResponse as WorkflowUserApprovalResponse,
     type WorkflowListResponsesWorkflowsCursor as WorkflowListResponsesWorkflowsCursor,
     type WorkflowCreateParams as WorkflowCreateParams,
+    type WorkflowRetrieveParams as WorkflowRetrieveParams,
     type WorkflowUpdateParams as WorkflowUpdateParams,
     type WorkflowListParams as WorkflowListParams,
+    type WorkflowDeleteParams as WorkflowDeleteParams,
     type WorkflowGetTagsParams as WorkflowGetTagsParams,
     type WorkflowRunParams as WorkflowRunParams,
     type WorkflowUserApprovalParams as WorkflowUserApprovalParams,