@scenario-labs/sdk 2.6.0 → 3.0.0

package/resources/workflows.d.ts

@@ -6,15 +6,15 @@ export declare class Workflows extends APIResource {
     /**
      * Create workflow
      */
-    create(body: WorkflowCreateParams, options?: RequestOptions): APIPromise<WorkflowCreateResponse>;
+    create(params: WorkflowCreateParams, options?: RequestOptions): APIPromise<WorkflowCreateResponse>;
     /**
      * Get workflow by ID
      */
-    retrieve(workflowID: string, options?: RequestOptions): APIPromise<WorkflowRetrieveResponse>;
+    retrieve(workflowID: string, query?: WorkflowRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<WorkflowRetrieveResponse>;
     /**
      * Update workflow
      */
-    update(workflowID: string, body: WorkflowUpdateParams, options?: RequestOptions): APIPromise<WorkflowUpdateResponse>;
+    update(workflowID: string, params: WorkflowUpdateParams, options?: RequestOptions): APIPromise<WorkflowUpdateResponse>;
     /**
      * List workflows
      */
@@ -22,7 +22,7 @@ export declare class Workflows extends APIResource {
     /**
      * Delete workflow
      */
-    delete(workflowID: string, options?: RequestOptions): APIPromise<unknown>;
+    delete(workflowID: string, params?: WorkflowDeleteParams | null | undefined, options?: RequestOptions): APIPromise<unknown>;
     /**
      * Get all unique tags from workflows in a project (all privacy levels). Optionally
      * filter by status.
@@ -38,11 +38,11 @@ export declare class Workflows extends APIResource {
      * rejected stand-alone node cancels the workflow; a rejected ForEach iteration
      * cascades to the surrounding loop.
      */
-    userApproval(workflowID: string, body: WorkflowUserApprovalParams, options?: RequestOptions): APIPromise<WorkflowUserApprovalResponse>;
+    userApproval(workflowID: string, params: WorkflowUserApprovalParams, options?: RequestOptions): APIPromise<WorkflowUserApprovalResponse>;
     /**
      * @deprecated Use `userApproval()` instead
      */
-    approveUser: (workflowID: string, body: WorkflowUserApprovalParams, options?: RequestOptions) => APIPromise<WorkflowUserApprovalResponse>;
+    approveUser: (workflowID: string, params: WorkflowUserApprovalParams, options?: RequestOptions) => APIPromise<WorkflowUserApprovalResponse>;
 }
 export type WorkflowListResponsesWorkflowsCursor = WorkflowsCursor<WorkflowListResponse>;
 export interface WorkflowCreateResponse {
@@ -76,6 +76,11 @@ export declare namespace WorkflowCreateResponse {
          * The flow of the workflow.
          */
         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.
          */
@@ -1079,6 +1084,11 @@ export declare namespace WorkflowRetrieveResponse {
          * The flow of the workflow.
          */
         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.
          */
@@ -2082,6 +2092,11 @@ export declare namespace WorkflowUpdateResponse {
          * The flow of the workflow.
          */
         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.
          */
@@ -3054,6 +3069,10 @@ export declare 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.
@@ -3072,15 +3091,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.
      */
@@ -3121,10 +3135,22 @@ export interface WorkflowListResponse {
      * A representation of an asset before being processed by the workflow
      */
     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.
@@ -3154,15 +3180,235 @@ 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 declare namespace WorkflowListResponse {
+    /**
+     * 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.
+     */
+    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'>;
+        /**
+         * 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;
+        /**
+         * 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;
+    }
+    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.
+         */
+        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;
+        }
+    }
+    /**
+     * A representation of an asset after being processed by the workflow
+     */
+    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
+     */
+    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;
+    }
     interface Flow {
         /**
          * The id of the node.
@@ -3716,232 +3962,17 @@ export declare namespace WorkflowListResponse {
         }
     }
     /**
-     * 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.
-     */
-    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'>;
-        /**
-         * 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;
-        /**
-         * 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;
-    }
-    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.
-         */
-        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;
-        }
-    }
-    /**
-     * A representation of an asset after being processed by the workflow
-     */
-    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
-     */
-    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;
-    }
-    /**
-     * Currently the thumbnail is identical to the after asset.
+     * Optional thumbnail asset for listing/display. Currently the thumbnail is
+     * identical to the after asset.
      */
     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.
      */
     interface UiConfig {
         /**
@@ -4745,6 +4776,26 @@ export declare namespace WorkflowRunResponse {
         interface Billing {
             cuCost: number;
             cuDiscount: number;
+            /**
+             * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
+             * top of the generation itself, such as `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.
@@ -4752,6 +4803,31 @@ export declare namespace WorkflowRunResponse {
              */
             disableRefund?: boolean;
         }
+        namespace Billing {
+            /**
+             * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
+             * top of the generation itself, such as `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.
+             */
+            interface CuCostDetails {
+                'ip-detection'?: number;
+                'slop-detection'?: number;
+            }
+        }
     }
     interface Workflow {
         /**
@@ -4780,6 +4856,11 @@ export declare namespace WorkflowRunResponse {
          * The flow of the workflow.
          */
         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.
          */
@@ -6437,6 +6518,26 @@ export declare namespace WorkflowUserApprovalResponse {
         interface Billing {
             cuCost: number;
             cuDiscount: number;
+            /**
+             * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
+             * top of the generation itself, such as `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.
@@ -6444,77 +6545,123 @@ export declare namespace WorkflowUserApprovalResponse {
              */
             disableRefund?: boolean;
         }
+        namespace Billing {
+            /**
+             * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
+             * top of the generation itself, such as `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.
+             */
+            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;
 }
@@ -7263,6 +7410,14 @@ export declare 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
@@ -7273,6 +7428,11 @@ export interface WorkflowListParams extends WorkflowsCursorParams {
      * values are `private`, `public` and `unlisted`. Default value is `private`.
      */
     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
@@ -7287,7 +7447,15 @@ export interface WorkflowListParams extends WorkflowsCursorParams {
     status?: 'draft' | 'ready';
     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;
 }
 export interface WorkflowRunParams {
@@ -7300,42 +7468,54 @@ 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';
 }
 export declare namespace Workflows {
-    export { type WorkflowCreateResponse as WorkflowCreateResponse, type WorkflowRetrieveResponse as WorkflowRetrieveResponse, type WorkflowUpdateResponse as WorkflowUpdateResponse, type WorkflowListResponse as WorkflowListResponse, type WorkflowDeleteResponse as WorkflowDeleteResponse, type WorkflowGetTagsResponse as WorkflowGetTagsResponse, type WorkflowRunResponse as WorkflowRunResponse, type WorkflowUserApprovalResponse as WorkflowUserApprovalResponse, type WorkflowListResponsesWorkflowsCursor as WorkflowListResponsesWorkflowsCursor, type WorkflowCreateParams as WorkflowCreateParams, type WorkflowUpdateParams as WorkflowUpdateParams, type WorkflowListParams as WorkflowListParams, type WorkflowGetTagsParams as WorkflowGetTagsParams, type WorkflowRunParams as WorkflowRunParams, type WorkflowUserApprovalParams as WorkflowUserApprovalParams, type WorkflowApproveUserParams as WorkflowApproveUserParams, };
+    export { type WorkflowCreateResponse as WorkflowCreateResponse, type WorkflowRetrieveResponse as WorkflowRetrieveResponse, type WorkflowUpdateResponse as WorkflowUpdateResponse, type WorkflowListResponse as WorkflowListResponse, type WorkflowDeleteResponse as WorkflowDeleteResponse, type WorkflowGetTagsResponse as WorkflowGetTagsResponse, type WorkflowRunResponse as WorkflowRunResponse, type WorkflowUserApprovalResponse as WorkflowUserApprovalResponse, type WorkflowListResponsesWorkflowsCursor as WorkflowListResponsesWorkflowsCursor, type WorkflowCreateParams as WorkflowCreateParams, type WorkflowRetrieveParams as WorkflowRetrieveParams, type WorkflowUpdateParams as WorkflowUpdateParams, type WorkflowListParams as WorkflowListParams, type WorkflowDeleteParams as WorkflowDeleteParams, type WorkflowGetTagsParams as WorkflowGetTagsParams, type WorkflowRunParams as WorkflowRunParams, type WorkflowUserApprovalParams as WorkflowUserApprovalParams, type WorkflowApproveUserParams as WorkflowApproveUserParams, };
 }
 //# sourceMappingURL=workflows.d.ts.map