@epilot/sdk 2.14.1 → 2.14.3

package/dist/{blueprint-manifest.d-2-TORV8o.d.cts → blueprint-manifest.d-D2I9nhZa.d.cts}

@@ -444,7 +444,7 @@ declare namespace Components {
              * Terraform addresses this resource references (for dependency-aware ignore)
              */
             depends_on_addresses?: string[];
-            impact_on_install?: ("create" | "update" | "internal-update" | "no-op" | "delete" | "ignored")[];
+            impact_on_install?: ("create" | "update" | "internal-update" | "no-op" | "delete" | "ignored" | "error")[];
             /**
              * Fields causing the updates / internal updates on a resource install
              */
@@ -500,6 +500,15 @@ declare namespace Components {
                  */
                 snapshot_id?: string | null;
                 resources?: RestoreOutcomeItem[];
+                /**
+                 * `true` iff at least one entry in `resources` has an effective
+                 * action (`action` is `restore` or `delete`). `false` when every
+                 * resource would be skipped (all `skip` / `failed`). Consumers
+                 * can gate the "Revert sync" confirm button on this — if false,
+                 * executing the revert is a no-op.
+                 *
+                 */
+                has_effective_changes?: boolean;
             } | null;
         }
         export interface BlueprintValidateJob {
@@ -554,6 +563,16 @@ declare namespace Components {
              * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
              */
             BlueprintID;
+            installation_job_id?: /**
+             * ID of a job
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintJobID;
+            /**
+             * Install engine used by the linked installation job, when known.
+             */
+            sync_engine?: "terraform" | "v3";
             status?: "IN_PROGRESS" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
             summary?: VerificationSummary;
             resource_results?: ResourceVerificationResult[];
@@ -562,6 +581,281 @@ declare namespace Components {
              */
             resource_results_s3_key?: string;
         }
+        /**
+         * Bulk install parent. Never carries target auth tokens.
+         */
+        export interface BulkInstall {
+            bulk_job_id?: string;
+            source_org_id?: string;
+            source_blueprint_id?: /**
+             * ID of a blueprint
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintID;
+            status?: /**
+             * Aggregate status for a bulk install or one of its targets.
+             * - `QUEUED`: not started yet
+             * - `IN_PROGRESS`: at least one target queued/in-progress, not all done
+             * - `SUCCESS`: all targets succeeded
+             * - `PARTIAL_SUCCESS`: all targets terminal with a mix of success/partial/failure
+             * - `FAILED`: all targets terminal and none succeeded or partially succeeded
+             *
+             */
+            BulkInstallStatus;
+            target_count?: number;
+            max_concurrency?: number;
+            counts?: /* Tally of target rows by status. Recomputed from target rows on each transition. */ BulkInstallCounts;
+            slug?: string;
+            options?: BlueprintInstallationJobOptions;
+            created_at?: string; // date-time
+            updated_at?: string; // date-time
+        }
+        /**
+         * Tally of target rows by status. Recomputed from target rows on each transition.
+         */
+        export interface BulkInstallCounts {
+            queued?: number;
+            in_progress?: number;
+            success?: number;
+            partial_success?: number;
+            failed?: number;
+        }
+        export interface BulkInstallCreateRequest {
+            /**
+             * The org that owns the source blueprint. Optional; defaults to the caller org and,
+             * if provided, must equal it — source reads use the caller's token, and the bulk job
+             * is owned/polled by the caller org. A different value is rejected with 400.
+             *
+             */
+            source_org_id?: string;
+            source_blueprint_id: /**
+             * ID of a blueprint
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintID;
+            /**
+             * Maximum number of concurrently active child installs.
+             */
+            max_concurrency?: number;
+            slug?: string;
+            options?: BlueprintInstallationJobOptions;
+            targets: [
+                BulkInstallTargetInput,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?,
+                BulkInstallTargetInput?
+            ];
+        }
+        /**
+         * Aggregate status for a bulk install or one of its targets.
+         * - `QUEUED`: not started yet
+         * - `IN_PROGRESS`: at least one target queued/in-progress, not all done
+         * - `SUCCESS`: all targets succeeded
+         * - `PARTIAL_SUCCESS`: all targets terminal with a mix of success/partial/failure
+         * - `FAILED`: all targets terminal and none succeeded or partially succeeded
+         *
+         */
+        export type BulkInstallStatus = "QUEUED" | "IN_PROGRESS" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
+        /**
+         * A single destination of a bulk install. `job` is the hydrated latest child
+         * install job derived from `job_ids.at(-1)`. Auth tokens are never stored or returned.
+         *
+         */
+        export interface BulkInstallTarget {
+            bulk_job_id?: string;
+            destination_org_id?: string;
+            destination_blueprint_id?: /**
+             * ID of a blueprint
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintID;
+            status?: /**
+             * Aggregate status for a bulk install or one of its targets.
+             * - `QUEUED`: not started yet
+             * - `IN_PROGRESS`: at least one target queued/in-progress, not all done
+             * - `SUCCESS`: all targets succeeded
+             * - `PARTIAL_SUCCESS`: all targets terminal with a mix of success/partial/failure
+             * - `FAILED`: all targets terminal and none succeeded or partially succeeded
+             *
+             */
+            BulkInstallStatus;
+            job_ids?: /**
+             * ID of a job
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintJobID[];
+            created_at?: string; // date-time
+            updated_at?: string; // date-time
+            /**
+             * The hydrated latest child install job (`job_ids.at(-1)`), when present.
+             */
+            job?: {
+                id?: /**
+                 * ID of a job
+                 * example:
+                 * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+                 */
+                BlueprintJobID;
+                events?: BlueprintJobEvent[];
+                triggered_at?: string; // date-time
+                created_by?: CallerIdentity;
+                job_type?: "install";
+                source_blueprint_id?: /**
+                 * ID of a blueprint
+                 * example:
+                 * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+                 */
+                BlueprintID;
+                source_blueprint_type?: "custom" | "file" | "marketplace" | "deploy" | "app";
+                source_org_id?: string;
+                source_blueprint_file?: string;
+                destination_blueprint_id?: /**
+                 * ID of a blueprint
+                 * example:
+                 * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+                 */
+                BlueprintID;
+                destination_org_id?: string;
+                /**
+                 * Blueprint slug for marketplace blueprints
+                 */
+                slug?: string;
+                /**
+                 * Engine used for this install job
+                 */
+                sync_engine?: "terraform" | "v3";
+                /**
+                 * Per-resource live status. Populated only for V3 installs.
+                 */
+                resource_progress?: V3ResourceProgressEntry[];
+                status?: "IN_PROGRESS" | "WAITING_USER_ACTION" | "CANCELED" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
+            } | null;
+        }
+        export interface BulkInstallTargetInput {
+            destination_org_id: string;
+            destination_blueprint_id?: /**
+             * ID of a blueprint
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintID;
+            /**
+             * Write-only org-scoped token for the destination org. Never persisted or returned.
+             */
+            destination_auth_token: string;
+        }
+        export interface BulkInstallTargetList {
+            results?: /**
+             * A single destination of a bulk install. `job` is the hydrated latest child
+             * install job derived from `job_ids.at(-1)`. Auth tokens are never stored or returned.
+             *
+             */
+            BulkInstallTarget[];
+            /**
+             * Opaque cursor for the next page. Absent on the last page.
+             */
+            next_cursor?: string;
+        }
         export interface CallerIdentity {
             /**
              * a human readable name of the caller (e.g. user name, token name or email address)
@@ -1811,6 +2105,13 @@ declare namespace Components {
              * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
              */
             BlueprintID;
+            installation_job_id?: /**
+             * ID of a job
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintJobID;
+            sync_engine?: "terraform" | "v3";
             summary?: VerificationSummary;
         }
         export interface LineageEntry {
@@ -2553,8 +2854,17 @@ declare namespace Components {
             resource_type?: /* Type of the resource */ ResourceNodeType;
             resource_name?: string;
             source_resource_id?: string;
+            source_resource_address?: string;
             destination_resource_id?: string;
+            destination_resource_address?: string;
             status?: "matched" | "mismatched" | "missing_in_destination" | "fetch_error";
+            /**
+             * Explains whether this result is likely downstream of another failed resource.
+             */
+            failure_context?: "depends_on_failed_resource" | "may_be_caused_by_failed_dependency";
+            failed_dependency_resource_ids?: string[];
+            failed_dependency_resource_names?: string[];
+            failed_dependency_addresses?: string[];
             field_diffs?: FieldDiff[];
             error?: string;
         }
@@ -2567,6 +2877,15 @@ declare namespace Components {
              */
             snapshot_id?: string | null;
             resources?: RestoreOutcomeItem[];
+            /**
+             * `true` iff at least one entry in `resources` has an effective
+             * action (`action` is `restore` or `delete`). `false` when every
+             * resource would be skipped (all `skip` / `failed`). Consumers
+             * can gate the "Revert sync" confirm button on this — if false,
+             * executing the revert is a no-op.
+             *
+             */
+            has_effective_changes?: boolean;
         }
         export interface RestoreOutcomeItem {
             lineage_id: string;
@@ -2583,7 +2902,7 @@ declare namespace Components {
             /**
              * Only set when `action == skip`.
              */
-            reason?: "modified" | "co_owned" | "delete_unsupported" | "heuristic_match";
+            reason?: "modified" | "delete_unsupported" | "heuristic_match" | "co_owned";
             /**
              * Only set when `reason == modified`. From the lineage row's last install write.
              */
@@ -2596,6 +2915,24 @@ declare namespace Components {
              * Only set when `action == failed`.
              */
             error_message?: string | null;
+            /**
+             * Mirrors the install manifest's `is_hidden` for this resource —
+             * helper resources (entity mappings, datasources, flow-template
+             * automations) the UI hides on every other resources view. Absent
+             * on rows from legacy installs without a persisted manifest.
+             *
+             */
+            is_hidden?: boolean;
+            /**
+             * Only set when `reason == co_owned`. The other live blueprint
+             * instances that still own this resource's lineage row — the
+             * "another sync" the skip refers to.
+             *
+             */
+            co_owned_by?: {
+                blueprint_id: string;
+                title?: string | null;
+            }[];
         }
         export interface RootResourceNode {
             /**
@@ -2705,13 +3042,14 @@ declare namespace Components {
                 string,
                 ...string[]
             ];
+            propagated_to?: string[];
             updated_at: string; // date-time
             updated_by?: string;
         }
         /**
          * Resource type for which custom uniqueness criteria can be configured.
          */
-        export type UniquenessCriteriaResourceType = "emailtemplate" | "product" | "price" | "tax" | "coupon" | "product_recommendation" | "file" | "document_template" | "schema" | "taxonomy" | "notification_template" | "family" | "permission" | "journey";
+        export type UniquenessCriteriaResourceType = "emailtemplate" | "product" | "price" | "tax" | "coupon" | "product_recommendation" | "file" | "document_template" | "notification_template" | "journey";
         export interface UploadFilePayload {
             /**
              * example:
@@ -2953,6 +3291,15 @@ declare namespace Paths {
             export type $200 = Components.Schemas.Blueprint;
         }
     }
+    namespace CreateBulkInstallV3 {
+        export type RequestBody = Components.Schemas.BulkInstallCreateRequest;
+        namespace Responses {
+            export type $202 = /* Bulk install parent. Never carries target auth tokens. */ Components.Schemas.BulkInstall;
+            export interface $400 {
+                message?: string;
+            }
+        }
+    }
     namespace CreateExport {
         export interface RequestBody {
             resources: [
@@ -3430,6 +3777,19 @@ declare namespace Paths {
             }
         }
     }
+    namespace GetBulkInstallV3 {
+        namespace Parameters {
+            export type BulkJobId = string;
+        }
+        export interface PathParameters {
+            bulk_job_id: Parameters.BulkJobId;
+        }
+        namespace Responses {
+            export type $200 = /* Bulk install parent. Never carries target auth tokens. */ Components.Schemas.BulkInstall;
+            export interface $404 {
+            }
+        }
+    }
     namespace GetJob {
         namespace Parameters {
             export type JobId = /**
@@ -3713,6 +4073,13 @@ declare namespace Paths {
              * Slug for marketplace blueprint consistency
              */
             slug?: string;
+            /**
+             * When `true`, the install skips the manual plan-approval step and applies
+             * straight after plan + snapshot succeed (no `:continue` call needed).
+             * Defaults to `false`. Used internally by the bulk-install worker.
+             *
+             */
+            auto_apply?: boolean;
         } | {
             source_org_id?: string;
             source_blueprint_id?: /**
@@ -3741,6 +4108,13 @@ declare namespace Paths {
              * Slug for marketplace blueprint consistency
              */
             slug?: string;
+            /**
+             * When `true`, the install skips the manual plan-approval step and applies
+             * straight after plan + snapshot succeed (no `:continue` call needed).
+             * Defaults to `false`. Used internally by the bulk-install worker.
+             *
+             */
+            auto_apply?: boolean;
         };
         namespace Responses {
             export interface $202 {
@@ -3792,6 +4166,25 @@ declare namespace Paths {
             }
         }
     }
+    namespace ListBulkInstallTargetsV3 {
+        namespace Parameters {
+            export type BulkJobId = string;
+            export type Cursor = string;
+            export type Limit = number;
+        }
+        export interface PathParameters {
+            bulk_job_id: Parameters.BulkJobId;
+        }
+        export interface QueryParameters {
+            limit?: Parameters.Limit;
+            cursor?: Parameters.Cursor;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.BulkInstallTargetList;
+            export interface $404 {
+            }
+        }
+    }
     namespace ListInstalledManifests {
         namespace Responses {
             export interface $200 {
@@ -3894,6 +4287,20 @@ declare namespace Paths {
         namespace Responses {
             export interface $200 {
                 results?: Components.Schemas.UniquenessCriteria[];
+                /**
+                 * Built-in default uniqueness fields per resource type, as used by
+                 * the install engines when no custom criteria are configured.
+                 *
+                 */
+                defaults?: {
+                    [name: string]: string[];
+                };
+                /**
+                 * Resource types whose criteria are fixed by epilot and cannot be
+                 * customized (writes are rejected). Shown read-only in the UI.
+                 *
+                 */
+                readonly_types?: string[];
             }
         }
     }
@@ -3945,6 +4352,29 @@ declare namespace Paths {
             }
         }
     }
+    namespace PublishBlueprintV3 {
+        namespace Parameters {
+            export type BlueprintId = /**
+             * ID of a blueprint
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            Components.Schemas.BlueprintID;
+        }
+        export interface PathParameters {
+            blueprint_id: Parameters.BlueprintId;
+        }
+        namespace Responses {
+            export interface $202 {
+                job_id: /**
+                 * ID of a job
+                 * example:
+                 * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+                 */
+                Components.Schemas.BlueprintJobID;
+            }
+        }
+    }
     namespace PublishMarketplaceListingVersion {
         namespace Parameters {
             export type ListingId = string;
@@ -3972,6 +4402,13 @@ declare namespace Paths {
                 string,
                 ...string[]
             ];
+            /**
+             * Org IDs this rule was also applied to (the UI's "Also apply to"
+             * selection). Stored so the selection survives reloads; each target
+             * org still holds its own criteria row.
+             *
+             */
+            propagated_to?: string[];
         }
         namespace Responses {
             export type $200 = Components.Schemas.UniquenessCriteria;
@@ -4022,6 +4459,36 @@ declare namespace Paths {
             }
         }
     }
+    namespace RetryBulkInstallTargetV3 {
+        namespace Parameters {
+            export type BulkJobId = string;
+            export type DestinationOrgId = string;
+        }
+        export interface PathParameters {
+            bulk_job_id: Parameters.BulkJobId;
+            destination_org_id: Parameters.DestinationOrgId;
+        }
+        export interface RequestBody {
+            /**
+             * Write-only auth token for the destination org used for the new attempt.
+             */
+            destination_auth_token: string;
+        }
+        namespace Responses {
+            export type $200 = /**
+             * A single destination of a bulk install. `job` is the hydrated latest child
+             * install job derived from `job_ids.at(-1)`. Auth tokens are never stored or returned.
+             *
+             */
+            Components.Schemas.BulkInstallTarget;
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+            export interface $409 {
+            }
+        }
+    }
     namespace RetryPatchOrg {
         namespace Parameters {
             export type BlueprintId = /**
@@ -4061,10 +4528,14 @@ declare namespace Paths {
              * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
              */
             Components.Schemas.BlueprintID;
+            export type Trigger = "manual" | "pre_sync" | "post_revert";
         }
         export interface PathParameters {
             blueprint_id: Parameters.BlueprintId;
         }
+        export interface QueryParameters {
+            trigger?: Parameters.Trigger;
+        }
         namespace Responses {
             export interface $202 {
                 job_id?: /**
@@ -4259,6 +4730,19 @@ declare namespace Paths {
              * Auth token with access to the destination org. Required for cross-org verification when the caller token only has access to the source org. If not provided, the caller's bearer token is used for both orgs.
              */
             destination_auth_token?: string;
+            /**
+             * Optional install job this verification is checking. If omitted, the latest destination blueprint installation job is used when available.
+             */
+            installation_job_id?: /**
+             * ID of a job
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            Components.Schemas.BlueprintJobID;
+            /**
+             * Optional install engine hint. Usually inferred from installation_job_id.
+             */
+            sync_engine?: "terraform" | "v3";
         }
         namespace Responses {
             export interface $202 {
@@ -4651,7 +5135,7 @@ interface OperationMethods {
    * Sync dependencies of all root resources in a Blueprint
    */
   'syncDependencies'(
-    parameters?: Parameters<Paths.SyncDependencies.PathParameters> | null,
+    parameters?: Parameters<Paths.SyncDependencies.QueryParameters & Paths.SyncDependencies.PathParameters> | null,
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.SyncDependencies.Responses.$202>
@@ -4718,7 +5202,11 @@ interface OperationMethods {
   /**
    * getBlueprintJob - Get Job
    * 
-   * Poll current state of a job.
+   * Poll the current state of a job. Serves both Terraform (v2) and V3-engine jobs —
+   * check `sync_engine` (`terraform` | `v3`) to tell them apart. V3 jobs additionally
+   * expose live `resource_progress[]`. V3 single-install and bulk-install child jobs
+   * are polled here.
+   *
    */
   'getBlueprintJob'(
     parameters?: Parameters<Paths.GetBlueprintJob.PathParameters> | null,
@@ -4728,7 +5216,11 @@ interface OperationMethods {
   /**
    * continueInstallationJob - Continue Installation Job
    * 
-   * Continue an installation job if it is waiting for user action.
+   * Resume an installation job that is paused at `status: "WAITING_USER_ACTION"` after
+   * planning. Works for both Terraform and V3 jobs. Not needed for V3 installs created
+   * with `auto_apply: true` (including all bulk-install child jobs), which apply
+   * without pausing.
+   *
    */
   'continueInstallationJob'(
     parameters?: Parameters<Paths.ContinueInstallationJob.PathParameters> | null,
@@ -4845,12 +5337,37 @@ interface OperationMethods {
     data?: Paths.PublishMarketplaceListingVersion.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.PublishMarketplaceListingVersion.Responses.$200>
+  /**
+   * publishBlueprintV3 - Publish Blueprint V3
+   *
+   * Starts an asynchronous V3 publication. The result is a signed, portable package; poll the existing blueprint job endpoint for completion.
+   */
+  'publishBlueprintV3'(
+    parameters?: Parameters<Paths.PublishBlueprintV3.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.PublishBlueprintV3.Responses.$202>
   /**
    * installBlueprintV3 - Install Blueprint V3
    * 
-   * Install a blueprint using the V3 engine (direct API calls, no Terraform).
-   * Creates resources in topological order with global ID replacement.
-   * Supports checkpoint-based resume on failure.
+   * Install a blueprint into a single destination org using the V3 engine (direct API
+   * calls, no Terraform). Creates resources in topological order with global ID
+   * replacement and supports checkpoint-based resume on failure.
+   *
+   * **Lifecycle (how to drive an install to completion):**
+   * 1. `POST /v3/blueprint-manifest/blueprint:install` returns `{ job_id }` (202).
+   * 2. Poll the job with `GET /v2/blueprint-manifest/jobs/{job_id}` — V3 jobs are
+   *    served by the same v2 jobs endpoints as Terraform jobs and are identified by
+   *    `sync_engine: "v3"`. Watch `status` and `resource_progress[]`.
+   * 3. If `auto_apply` is `false` (default), the job pauses at
+   *    `status: "WAITING_USER_ACTION"` after planning. Resume it with
+   *    `POST /v2/blueprint-manifest/jobs/{job_id}:continue`.
+   * 4. If `auto_apply` is `true`, the engine applies automatically after plan +
+   *    snapshot — no `:continue` call is needed. This is what the bulk-install worker
+   *    uses; to install into many orgs at once prefer `POST .../bulk-installs`.
+   *
+   * For cross-org installs, pass `destination_auth_token` (the destination org's
+   * token); reads use the caller's bearer token, writes use that token.
    * 
    */
   'installBlueprintV3'(
@@ -4919,6 +5436,64 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetBlueprintLineageV3.Responses.$200>
+  /**
+   * createBulkInstallV3 - Create Bulk Install V3
+   *
+   * Install one source blueprint into many destination organizations in a single
+   * request. The server schedules child V3 installs with `auto_apply=true` and caps
+   * active installs at `max_concurrency`. Per-target failures are isolated and
+   * retryable; they do not stop the remaining targets.
+   *
+   * Each target carries its own write-only `destination_auth_token` (org-scoped).
+   * Tokens are passed to the worker via Step Functions input only — they are never
+   * persisted in DynamoDB nor returned by any endpoint.
+   *
+   */
+  'createBulkInstallV3'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.CreateBulkInstallV3.RequestBody,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.CreateBulkInstallV3.Responses.$202>
+  /**
+   * getBulkInstallV3 - Get Bulk Install V3
+   *
+   * Returns the bulk install parent with aggregate status and counts. Scoped by the
+   * caller org as `source_org_id`. Target rows are not included — use the targets
+   * endpoint to page through them.
+   *
+   */
+  'getBulkInstallV3'(
+    parameters?: Parameters<Paths.GetBulkInstallV3.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.GetBulkInstallV3.Responses.$200>
+  /**
+   * listBulkInstallTargetsV3 - List Bulk Install Targets V3
+   *
+   * Pages through the bulk install's target rows. Each row hydrates its latest child
+   * install job (`job_ids.at(-1)`) with the standard V3 job shape (`events[]`,
+   * `resource_progress[]`) so callers can inspect per-resource progress and errors.
+   *
+   */
+  'listBulkInstallTargetsV3'(
+    parameters?: Parameters<Paths.ListBulkInstallTargetsV3.QueryParameters & Paths.ListBulkInstallTargetsV3.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.ListBulkInstallTargetsV3.Responses.$200>
+  /**
+   * retryBulkInstallTargetV3 - Retry Bulk Install Target V3
+   *
+   * Retries a single failed target. Allowed only for `FAILED` and `PARTIAL_SUCCESS`
+   * targets. Starts a new child install with `auto_apply=true`, appends its job id to
+   * `job_ids`, and reuses the same target row. Only the destination auth token may be
+   * supplied for the new attempt; source/destination identifiers are immutable.
+   *
+   */
+  'retryBulkInstallTargetV3'(
+    parameters?: Parameters<Paths.RetryBulkInstallTargetV3.PathParameters> | null,
+    data?: Paths.RetryBulkInstallTargetV3.RequestBody,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.RetryBulkInstallTargetV3.Responses.$200>
   /**
    * listUniquenessCriteria - listUniquenessCriteria
    * 
@@ -5398,7 +5973,7 @@ interface PathsDictionary {
      * Sync dependencies of all root resources in a Blueprint
      */
     'post'(
-      parameters?: Parameters<Paths.SyncDependencies.PathParameters> | null,
+      parameters?: Parameters<Paths.SyncDependencies.QueryParameters & Paths.SyncDependencies.PathParameters> | null,
       data?: any,
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.SyncDependencies.Responses.$202>
@@ -5473,7 +6048,11 @@ interface PathsDictionary {
     /**
      * getBlueprintJob - Get Job
      * 
-     * Poll current state of a job.
+     * Poll the current state of a job. Serves both Terraform (v2) and V3-engine jobs —
+     * check `sync_engine` (`terraform` | `v3`) to tell them apart. V3 jobs additionally
+     * expose live `resource_progress[]`. V3 single-install and bulk-install child jobs
+     * are polled here.
+     *
      */
     'get'(
       parameters?: Parameters<Paths.GetBlueprintJob.PathParameters> | null,
@@ -5485,7 +6064,11 @@ interface PathsDictionary {
     /**
      * continueInstallationJob - Continue Installation Job
      * 
-     * Continue an installation job if it is waiting for user action.
+     * Resume an installation job that is paused at `status: "WAITING_USER_ACTION"` after
+     * planning. Works for both Terraform and V3 jobs. Not needed for V3 installs created
+     * with `auto_apply: true` (including all bulk-install child jobs), which apply
+     * without pausing.
+     *
      */
     'post'(
       parameters?: Parameters<Paths.ContinueInstallationJob.PathParameters> | null,
@@ -5617,13 +6200,40 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.PublishMarketplaceListingVersion.Responses.$200>
   }
+  ['/v3/blueprint-manifest/blueprints/{blueprint_id}:publish']: {
+    /**
+     * publishBlueprintV3 - Publish Blueprint V3
+     *
+     * Starts an asynchronous V3 publication. The result is a signed, portable package; poll the existing blueprint job endpoint for completion.
+     */
+    'post'(
+      parameters?: Parameters<Paths.PublishBlueprintV3.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.PublishBlueprintV3.Responses.$202>
+  }
   ['/v3/blueprint-manifest/blueprint:install']: {
     /**
      * installBlueprintV3 - Install Blueprint V3
      * 
-     * Install a blueprint using the V3 engine (direct API calls, no Terraform).
-     * Creates resources in topological order with global ID replacement.
-     * Supports checkpoint-based resume on failure.
+     * Install a blueprint into a single destination org using the V3 engine (direct API
+     * calls, no Terraform). Creates resources in topological order with global ID
+     * replacement and supports checkpoint-based resume on failure.
+     *
+     * **Lifecycle (how to drive an install to completion):**
+     * 1. `POST /v3/blueprint-manifest/blueprint:install` returns `{ job_id }` (202).
+     * 2. Poll the job with `GET /v2/blueprint-manifest/jobs/{job_id}` — V3 jobs are
+     *    served by the same v2 jobs endpoints as Terraform jobs and are identified by
+     *    `sync_engine: "v3"`. Watch `status` and `resource_progress[]`.
+     * 3. If `auto_apply` is `false` (default), the job pauses at
+     *    `status: "WAITING_USER_ACTION"` after planning. Resume it with
+     *    `POST /v2/blueprint-manifest/jobs/{job_id}:continue`.
+     * 4. If `auto_apply` is `true`, the engine applies automatically after plan +
+     *    snapshot — no `:continue` call is needed. This is what the bulk-install worker
+     *    uses; to install into many orgs at once prefer `POST .../bulk-installs`.
+     *
+     * For cross-org installs, pass `destination_auth_token` (the destination org's
+     * token); reads use the caller's bearer token, writes use that token.
      * 
      */
     'post'(
@@ -5699,6 +6309,72 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetBlueprintLineageV3.Responses.$200>
   }
+  ['/v3/blueprint-manifest/bulk-installs']: {
+    /**
+     * createBulkInstallV3 - Create Bulk Install V3
+     *
+     * Install one source blueprint into many destination organizations in a single
+     * request. The server schedules child V3 installs with `auto_apply=true` and caps
+     * active installs at `max_concurrency`. Per-target failures are isolated and
+     * retryable; they do not stop the remaining targets.
+     *
+     * Each target carries its own write-only `destination_auth_token` (org-scoped).
+     * Tokens are passed to the worker via Step Functions input only — they are never
+     * persisted in DynamoDB nor returned by any endpoint.
+     *
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.CreateBulkInstallV3.RequestBody,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.CreateBulkInstallV3.Responses.$202>
+  }
+  ['/v3/blueprint-manifest/bulk-installs/{bulk_job_id}']: {
+    /**
+     * getBulkInstallV3 - Get Bulk Install V3
+     *
+     * Returns the bulk install parent with aggregate status and counts. Scoped by the
+     * caller org as `source_org_id`. Target rows are not included — use the targets
+     * endpoint to page through them.
+     *
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetBulkInstallV3.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.GetBulkInstallV3.Responses.$200>
+  }
+  ['/v3/blueprint-manifest/bulk-installs/{bulk_job_id}/targets']: {
+    /**
+     * listBulkInstallTargetsV3 - List Bulk Install Targets V3
+     *
+     * Pages through the bulk install's target rows. Each row hydrates its latest child
+     * install job (`job_ids.at(-1)`) with the standard V3 job shape (`events[]`,
+     * `resource_progress[]`) so callers can inspect per-resource progress and errors.
+     *
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListBulkInstallTargetsV3.QueryParameters & Paths.ListBulkInstallTargetsV3.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.ListBulkInstallTargetsV3.Responses.$200>
+  }
+  ['/v3/blueprint-manifest/bulk-installs/{bulk_job_id}/targets/{destination_org_id}:retry']: {
+    /**
+     * retryBulkInstallTargetV3 - Retry Bulk Install Target V3
+     *
+     * Retries a single failed target. Allowed only for `FAILED` and `PARTIAL_SUCCESS`
+     * targets. Starts a new child install with `auto_apply=true`, appends its job id to
+     * `job_ids`, and reuses the same target row. Only the destination auth token may be
+     * supplied for the new attempt; source/destination identifiers are immutable.
+     *
+     */
+    'post'(
+      parameters?: Parameters<Paths.RetryBulkInstallTargetV3.PathParameters> | null,
+      data?: Paths.RetryBulkInstallTargetV3.RequestBody,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.RetryBulkInstallTargetV3.Responses.$200>
+  }
   ['/v1/blueprint-manifest/uniqueness-criteria']: {
     /**
      * listUniquenessCriteria - listUniquenessCriteria
@@ -5774,6 +6450,13 @@ type BlueprintResourceID = Components.Schemas.BlueprintResourceID;
 type BlueprintRestoreJob = Components.Schemas.BlueprintRestoreJob;
 type BlueprintValidateJob = Components.Schemas.BlueprintValidateJob;
 type BlueprintVerificationJob = Components.Schemas.BlueprintVerificationJob;
+type BulkInstall = Components.Schemas.BulkInstall;
+type BulkInstallCounts = Components.Schemas.BulkInstallCounts;
+type BulkInstallCreateRequest = Components.Schemas.BulkInstallCreateRequest;
+type BulkInstallStatus = Components.Schemas.BulkInstallStatus;
+type BulkInstallTarget = Components.Schemas.BulkInstallTarget;
+type BulkInstallTargetInput = Components.Schemas.BulkInstallTargetInput;
+type BulkInstallTargetList = Components.Schemas.BulkInstallTargetList;
 type CallerIdentity = Components.Schemas.CallerIdentity;
 type CommonBlueprintFields = Components.Schemas.CommonBlueprintFields;
 type CommonBlueprintJobFields = Components.Schemas.CommonBlueprintJobFields;
@@ -5828,4 +6511,4 @@ type V3ResourceProgressEntry = Components.Schemas.V3ResourceProgressEntry;
 type VerificationSummary = Components.Schemas.VerificationSummary;
 type VirtualResourceNodeGroup = Components.Schemas.VirtualResourceNodeGroup;
 
-export { type MarketplaceListingVersion as $, type AppBlueprint as A, type Blueprint as B, type Client as C, type CustomBlueprint as D, type DeployedBlueprint as E, type DetectChangesResult as F, type FieldDiff as G, type FileBlueprint as H, type FormattedError as I, type FormattedErrorCodes as J, type FormattedErrorData as K, type InstalledMarketplaceBlueprintItem as L, type Job as M, type JobID as N, type OperationMethods as O, Paths as P, type JobStatus as Q, type LatestBlueprintVerification as R, type LineageEntry as S, type Manifest as T, type ManifestID as U, type ManifestItem as V, type ManifestSource as W, type ManifestTimestampFields as X, type MarketplaceBlueprint as Y, type MarketplaceListing as Z, type MarketplaceListingUpdate as _, Components as a, type OrgPatchExecution as a0, type PatchFieldDiff as a1, type PatchResourceDiff as a2, type PlanChanges as a3, type PreInstallRequirements as a4, type PutManifestPayload as a5, type ResourceNode as a6, type ResourceNodeType as a7, type ResourceReplacement as a8, type ResourceVerificationResult as a9, type RestoreOutcome as aa, type RestoreOutcomeItem as ab, type RootResourceNode as ac, type S3Reference as ad, type SelectedResources as ae, type SuggestBlueprintResourcesRequest as af, type SuggestBlueprintResourcesResponse as ag, type UniquenessCriteria as ah, type UniquenessCriteriaResourceType as ai, type UploadFilePayload as aj, type V3ResourceProgressEntry as ak, type VerificationSummary as al, type VirtualResourceNodeGroup as am, type PathsDictionary as b, type BlueprintDependenciesSyncJob as c, type BlueprintExportJob as d, type BlueprintID as e, type BlueprintInstallStatus as f, type BlueprintInstallationJob as g, type BlueprintInstallationJobOptions as h, type BlueprintJob as i, type BlueprintJobEvent as j, type BlueprintJobID as k, type BlueprintPatch as l, type BlueprintPatchWithResults as m, type BlueprintPreview as n, type BlueprintResource as o, type BlueprintResourceID as p, type BlueprintRestoreJob as q, type BlueprintValidateJob as r, type BlueprintVerificationJob as s, type CallerIdentity as t, type CommonBlueprintFields as u, type CommonBlueprintJobFields as v, type CommonImportFields as w, type CommonManifestFields as x, type CommonMarkdownFields as y, type CommonResourceNode as z };
+export { type ManifestID as $, type AppBlueprint as A, type Blueprint as B, type Client as C, type CallerIdentity as D, type CommonBlueprintFields as E, type CommonBlueprintJobFields as F, type CommonImportFields as G, type CommonManifestFields as H, type CommonMarkdownFields as I, type CommonResourceNode as J, type CustomBlueprint as K, type DeployedBlueprint as L, type DetectChangesResult as M, type FieldDiff as N, type OperationMethods as O, Paths as P, type FileBlueprint as Q, type FormattedError as R, type FormattedErrorCodes as S, type FormattedErrorData as T, type InstalledMarketplaceBlueprintItem as U, type Job as V, type JobID as W, type JobStatus as X, type LatestBlueprintVerification as Y, type LineageEntry as Z, type Manifest as _, Components as a, type ManifestItem as a0, type ManifestSource as a1, type ManifestTimestampFields as a2, type MarketplaceBlueprint as a3, type MarketplaceListing as a4, type MarketplaceListingUpdate as a5, type MarketplaceListingVersion as a6, type OrgPatchExecution as a7, type PatchFieldDiff as a8, type PatchResourceDiff as a9, type PlanChanges as aa, type PreInstallRequirements as ab, type PutManifestPayload as ac, type ResourceNode as ad, type ResourceNodeType as ae, type ResourceReplacement as af, type ResourceVerificationResult as ag, type RestoreOutcome as ah, type RestoreOutcomeItem as ai, type RootResourceNode as aj, type S3Reference as ak, type SelectedResources as al, type SuggestBlueprintResourcesRequest as am, type SuggestBlueprintResourcesResponse as an, type UniquenessCriteria as ao, type UniquenessCriteriaResourceType as ap, type UploadFilePayload as aq, type V3ResourceProgressEntry as ar, type VerificationSummary as as, type VirtualResourceNodeGroup as at, type PathsDictionary as b, type BlueprintDependenciesSyncJob as c, type BlueprintExportJob as d, type BlueprintID as e, type BlueprintInstallStatus as f, type BlueprintInstallationJob as g, type BlueprintInstallationJobOptions as h, type BlueprintJob as i, type BlueprintJobEvent as j, type BlueprintJobID as k, type BlueprintPatch as l, type BlueprintPatchWithResults as m, type BlueprintPreview as n, type BlueprintResource as o, type BlueprintResourceID as p, type BlueprintRestoreJob as q, type BlueprintValidateJob as r, type BlueprintVerificationJob as s, type BulkInstall as t, type BulkInstallCounts as u, type BulkInstallCreateRequest as v, type BulkInstallStatus as w, type BulkInstallTarget as x, type BulkInstallTargetInput as y, type BulkInstallTargetList as z };