@epilot/cli 0.1.11 → 0.1.15

package/definitions/blueprint-manifest.json

@@ -1,8 +1,8 @@
 {
-  "openapi": "3.1.0",
+  "openapi": "3.0.2",
   "info": {
     "title": "Blueprint Manifest API",
-    "version": "4.6.1",
+    "version": "4.6.4",
     "description": "Service to create and install Blueprint Manifest files"
   },
   "tags": [
@@ -29,6 +29,14 @@
     {
       "name": "Installations",
       "description": "Manage installation jobs"
+    },
+    {
+      "name": "Marketplace Listings",
+      "description": "Manage marketplace listings for blueprints"
+    },
+    {
+      "name": "Marketplace Listing Versions",
+      "description": "Manage versions for marketplace listings"
     }
   ],
   "security": [
@@ -936,6 +944,10 @@
                   "slug": {
                     "type": "string",
                     "description": "Slug to enforce in this blueprint. Used in marketplace blueprints to keep it consistent with webflow."
+                  },
+                  "auto_enable_features": {
+                    "type": "boolean",
+                    "description": "If true, automatically enable required features in the destination org before installing"
                   }
                 },
                 "required": [
@@ -1124,6 +1136,94 @@
         }
       }
     },
+    "/v2/blueprint-manifest/blueprints/{blueprint_id}:verify": {
+      "post": {
+        "operationId": "verifyBlueprint",
+        "summary": "verifyBlueprint",
+        "description": "Start a blueprint verification job. Compares resource configurations between a source org\nand a destination org to verify that a sync/install was successful.\nReturns 202 Accepted with job_id. Poll GET /jobs/{job_id} for status, summary, and resource_results.\n",
+        "tags": [
+          "Blueprints"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "required": true,
+            "name": "blueprint_id",
+            "schema": {
+              "$ref": "#/components/schemas/BlueprintID"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "source_org_id",
+                  "source_blueprint_id",
+                  "destination_org_id",
+                  "destination_blueprint_id"
+                ],
+                "properties": {
+                  "source_org_id": {
+                    "type": "string",
+                    "description": "Organization ID of the source org"
+                  },
+                  "source_blueprint_id": {
+                    "$ref": "#/components/schemas/BlueprintID"
+                  },
+                  "destination_org_id": {
+                    "type": "string",
+                    "description": "Organization ID of the destination org"
+                  },
+                  "destination_blueprint_id": {
+                    "$ref": "#/components/schemas/BlueprintID"
+                  },
+                  "source_auth_token": {
+                    "type": "string",
+                    "description": "Auth token with access to the source org (e.g. pipeline token). If not provided, the caller's bearer token is used for both orgs."
+                  },
+                  "destination_auth_token": {
+                    "type": "string",
+                    "description": "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."
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "Verification job started",
+            "headers": {
+              "Location": {
+                "description": "URL to poll the job",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "job_id": {
+                      "$ref": "#/components/schemas/BlueprintJobID"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Blueprint not found"
+          }
+        }
+      }
+    },
     "/v2/blueprint-manifest/blueprints/{blueprint_id}:export": {
       "post": {
         "operationId": "exportBlueprint",
@@ -1214,8 +1314,14 @@
                         "properties": {
                           "slug": {
                             "type": "string",
+                            "description": "The installation slug identifier for the blueprint (used for publishing).",
                             "example": "wallbox_b2c"
                           },
+                          "marketplace_slug": {
+                            "type": "string",
+                            "description": "The marketplace page slug for the Webflow CMS item (used for display).",
+                            "example": "wallbox-b2c"
+                          },
                           "version": {
                             "type": "string",
                             "example": "v1.0.0"
@@ -1868,153 +1974,803 @@
           }
         }
       }
-    }
-  },
-  "components": {
-    "schemas": {
-      "BlueprintID": {
-        "type": "string",
-        "description": "ID of a blueprint",
-        "example": "c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341"
-      },
-      "BlueprintResourceID": {
-        "type": "string",
-        "description": "ID of a blueprint resource",
-        "example": "c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341"
-      },
-      "CommonBlueprintFields": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "$ref": "#/components/schemas/BlueprintID"
-          },
-          "title": {
-            "type": "string"
-          },
-          "slug": {
-            "type": "string"
-          },
-          "description": {
-            "type": "object",
-            "properties": {
-              "preinstall": {
-                "type": "string",
-                "description": "Markdown content shown before starting to install the blueprint",
-                "example": "This is the content of the preinstall.md file which contains the blueprint description.\n"
-              },
-              "postinstall": {
-                "type": "string",
-                "description": "Markdown content to be displayed when showing the plan to install blueprint",
-                "example": "This is the content of the postinstall.md file\n"
-              }
+    },
+    "/v1/blueprints/{blueprint_id}/marketplace-listing": {
+      "post": {
+        "operationId": "createMarketplaceListing",
+        "summary": "createMarketplaceListing",
+        "description": "Create a marketplace listing for a blueprint. Returns 409 if one already exists.",
+        "tags": [
+          "Marketplace Listings"
+        ],
+        "parameters": [
+          {
+            "name": "blueprint_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
             }
-          },
-          "version": {
-            "type": "string"
-          },
-          "deployments": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "source_org_id": {
-                  "type": "string"
-                },
-                "source_blueprint_id": {
-                  "type": "string"
-                },
-                "destination_org_id": {
-                  "type": "string"
-                },
-                "destination_blueprint_id": {
-                  "type": "string"
-                },
-                "triggered_at": {
-                  "type": "string",
-                  "format": "date-time"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "name"
+                ],
+                "properties": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "slug": {
+                    "type": "string"
+                  }
                 }
               }
             }
-          },
-          "is_verified": {
-            "type": "boolean",
-            "description": "Whether the blueprint is verified by epilot"
-          },
-          "installation_status": {
-            "type": "string",
-            "enum": [
-              "IN_PROGRESS",
-              "CANCELED",
-              "PARTIAL",
-              "SUCCESS",
-              "FAILED"
-            ]
-          },
-          "created_at": {
-            "type": "string",
-            "format": "date-time"
-          },
-          "updated_at": {
-            "type": "string",
-            "format": "date-time"
-          },
-          "created_by": {
-            "$ref": "#/components/schemas/CallerIdentity"
-          },
-          "updated_by": {
-            "$ref": "#/components/schemas/CallerIdentity"
-          },
-          "installation_job_ids": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/BlueprintJobID"
-            }
-          },
-          "source_blueprint_id": {
-            "description": "ID of the blueprint that brought this blueprint to the destination org (deployed or installed)",
-            "$ref": "#/components/schemas/BlueprintID"
-          },
-          "archived": {
-            "type": "boolean",
-            "description": "Whether the blueprint is archived (soft-deleted). Archived blueprints are hidden from the main list.",
-            "default": false
-          },
-          "docs_url": {
-            "type": "string",
-            "description": "URL to the blueprint documentation"
-          },
-          "recommended_apps": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "List of recommended app IDs for the blueprint"
-          },
-          "required_features": {
-            "type": "object",
-            "description": "Feature constraints for blueprint installation",
-            "properties": {
-              "enabled": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                },
-                "description": "Features that must be enabled in the target org"
-              },
-              "disabled": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                },
-                "description": "Features that must be disabled in the target org"
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Marketplace listing created",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MarketplaceListing"
+                }
               }
             }
           },
-          "zip_file_name": {
-            "type": "string",
-            "description": "Custom name for the exported zip file"
+          "409": {
+            "description": "Listing already exists for this blueprint"
           }
-        },
+        }
+      },
+      "get": {
+        "operationId": "getMarketplaceListing",
+        "summary": "getMarketplaceListing",
+        "description": "Get marketplace listing for a blueprint including all versions",
+        "tags": [
+          "Marketplace Listings"
+        ],
+        "parameters": [
+          {
+            "name": "blueprint_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Marketplace listing with versions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/MarketplaceListing"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "versions": {
+                          "type": "array",
+                          "items": {
+                            "$ref": "#/components/schemas/MarketplaceListingVersion"
+                          }
+                        },
+                        "has_publishable_draft": {
+                          "type": "boolean"
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Listing not found"
+          }
+        }
+      }
+    },
+    "/v1/marketplace-listings": {
+      "get": {
+        "operationId": "listMarketplaceListings",
+        "summary": "listMarketplaceListings",
+        "description": "List all marketplace listings for the authenticated organization",
+        "tags": [
+          "Marketplace Listings"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of marketplace listings",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "listings": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/MarketplaceListing"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/marketplace-listings/{listing_id}": {
+      "get": {
+        "operationId": "getMarketplaceListingById",
+        "summary": "getMarketplaceListingById",
+        "description": "Get marketplace listing by listing ID including all versions",
+        "tags": [
+          "Marketplace Listings"
+        ],
+        "parameters": [
+          {
+            "name": "listing_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Marketplace listing with versions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/MarketplaceListing"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "versions": {
+                          "type": "array",
+                          "items": {
+                            "$ref": "#/components/schemas/MarketplaceListingVersion"
+                          }
+                        },
+                        "has_publishable_draft": {
+                          "type": "boolean"
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Listing not found"
+          }
+        }
+      },
+      "patch": {
+        "operationId": "updateMarketplaceListing",
+        "summary": "updateMarketplaceListing",
+        "description": "Update listing-level fields",
+        "tags": [
+          "Marketplace Listings"
+        ],
+        "parameters": [
+          {
+            "name": "listing_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/MarketplaceListingUpdate"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Updated marketplace listing",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MarketplaceListing"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Listing not found"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "deleteMarketplaceListing",
+        "summary": "deleteMarketplaceListing",
+        "description": "Delete listing and all versions",
+        "tags": [
+          "Marketplace Listings"
+        ],
+        "parameters": [
+          {
+            "name": "listing_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Listing deleted"
+          },
+          "404": {
+            "description": "Listing not found"
+          }
+        }
+      }
+    },
+    "/v1/marketplace-listings/{listing_id}/versions": {
+      "post": {
+        "operationId": "createMarketplaceListingVersion",
+        "summary": "createMarketplaceListingVersion",
+        "description": "Create a draft version; auto-snapshots resources, requiredFeatures, recommendedApps from current blueprint",
+        "tags": [
+          "Marketplace Listing Versions"
+        ],
+        "parameters": [
+          {
+            "name": "listing_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Draft version created",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MarketplaceListingVersion"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Listing not found"
+          }
+        }
+      },
+      "get": {
+        "operationId": "listMarketplaceListingVersions",
+        "summary": "listMarketplaceListingVersions",
+        "description": "List all versions for a listing, newest first",
+        "tags": [
+          "Marketplace Listing Versions"
+        ],
+        "parameters": [
+          {
+            "name": "listing_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of versions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "versions": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/MarketplaceListingVersion"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/marketplace-listings/{listing_id}/versions/{version_id}": {
+      "patch": {
+        "operationId": "updateMarketplaceListingVersion",
+        "summary": "updateMarketplaceListingVersion",
+        "description": "Update updateNote, requiredFeatures, or recommendedApps on a draft version",
+        "tags": [
+          "Marketplace Listing Versions"
+        ],
+        "parameters": [
+          {
+            "name": "listing_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "version_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "update_note": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "required_features": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "recommended_apps": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Updated version",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MarketplaceListingVersion"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Cannot update non-draft version"
+          },
+          "404": {
+            "description": "Version not found"
+          }
+        }
+      }
+    },
+    "/v1/marketplace-listings/{listing_id}/versions/{version_id}/publish": {
+      "post": {
+        "operationId": "publishMarketplaceListingVersion",
+        "summary": "publishMarketplaceListingVersion",
+        "description": "Publish a draft version; archives the previous live version",
+        "tags": [
+          "Marketplace Listing Versions"
+        ],
+        "parameters": [
+          {
+            "name": "listing_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "version_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "version_name"
+                ],
+                "properties": {
+                  "version_name": {
+                    "type": "string"
+                  },
+                  "update_note": {
+                    "type": "string",
+                    "nullable": true
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Published version",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MarketplaceListingVersion"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Version not publishable or version_name already taken"
+          },
+          "404": {
+            "description": "Version not found"
+          }
+        }
+      }
+    },
+    "/v3/blueprint-manifest/blueprint:install": {
+      "post": {
+        "operationId": "installBlueprintV3",
+        "summary": "Install Blueprint V3",
+        "description": "Install a blueprint using the V3 engine (direct API calls, no Terraform).\nCreates resources in topological order with global ID replacement.\nSupports checkpoint-based resume on failure.\n",
+        "tags": [
+          "Blueprints"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "source_org_id": {
+                    "type": "string"
+                  },
+                  "source_blueprint_id": {
+                    "$ref": "#/components/schemas/BlueprintID"
+                  },
+                  "source_blueprint_file": {
+                    "type": "string",
+                    "description": "S3 key to the blueprint zip file"
+                  },
+                  "destination_org_id": {
+                    "type": "string"
+                  },
+                  "destination_blueprint_id": {
+                    "$ref": "#/components/schemas/BlueprintID"
+                  },
+                  "destination_auth_token": {
+                    "type": "string",
+                    "description": "Auth token for the destination org. Required for cross-org installs where the caller's token belongs to the source org. Defaults to the caller's bearer token."
+                  },
+                  "options": {
+                    "$ref": "#/components/schemas/BlueprintInstallationJobOptions"
+                  },
+                  "slug": {
+                    "type": "string",
+                    "description": "Slug for marketplace blueprint consistency"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "V3 install job started",
+            "headers": {
+              "Location": {
+                "description": "URL to poll the job",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "job_id": {
+                      "$ref": "#/components/schemas/BlueprintJobID"
+                    },
+                    "destination_blueprint_id": {
+                      "$ref": "#/components/schemas/BlueprintID"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v3/blueprint-manifest/blueprints/{blueprint_id}/lineage": {
+      "get": {
+        "operationId": "getBlueprintLineageV3",
+        "summary": "Get Blueprint Lineage V3",
+        "description": "Returns the lineage registry entries for a blueprint's resources in the current org.\nShows the mapping between source lineage IDs and target resource IDs.\n",
+        "tags": [
+          "Blueprints"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "required": true,
+            "name": "blueprint_id",
+            "schema": {
+              "$ref": "#/components/schemas/BlueprintID"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lineage entries for the blueprint",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "total": {
+                      "type": "integer"
+                    },
+                    "entries": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/LineageEntry"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "LineageEntry": {
+        "type": "object",
+        "properties": {
+          "lineage_id": {
+            "type": "string",
+            "description": "Immutable resource identity across orgs"
+          },
+          "target_id": {
+            "type": "string",
+            "description": "Resource ID in the destination org"
+          },
+          "resource_type": {
+            "$ref": "#/components/schemas/ResourceNodeType"
+          },
+          "blueprint_instance_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "fidelity": {
+            "type": "string",
+            "enum": [
+              "full",
+              "partial"
+            ]
+          },
+          "last_synced_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "BlueprintID": {
+        "type": "string",
+        "description": "ID of a blueprint",
+        "example": "c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341"
+      },
+      "BlueprintResourceID": {
+        "type": "string",
+        "description": "ID of a blueprint resource",
+        "example": "c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341"
+      },
+      "CommonBlueprintFields": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "$ref": "#/components/schemas/BlueprintID"
+          },
+          "title": {
+            "type": "string"
+          },
+          "slug": {
+            "type": "string"
+          },
+          "description": {
+            "type": "object",
+            "properties": {
+              "preinstall": {
+                "type": "string",
+                "description": "Markdown content shown before starting to install the blueprint",
+                "example": "This is the content of the preinstall.md file which contains the blueprint description.\n"
+              },
+              "postinstall": {
+                "type": "string",
+                "description": "Markdown content to be displayed when showing the plan to install blueprint",
+                "example": "This is the content of the postinstall.md file\n"
+              }
+            }
+          },
+          "version": {
+            "type": "string"
+          },
+          "deployments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "source_org_id": {
+                  "type": "string"
+                },
+                "source_blueprint_id": {
+                  "type": "string"
+                },
+                "destination_org_id": {
+                  "type": "string"
+                },
+                "destination_blueprint_id": {
+                  "type": "string"
+                },
+                "triggered_at": {
+                  "type": "string",
+                  "format": "date-time"
+                },
+                "note": {
+                  "type": "string",
+                  "description": "User-provided note about this synchronization"
+                }
+              }
+            }
+          },
+          "is_verified": {
+            "type": "boolean",
+            "description": "Whether the blueprint is verified by epilot"
+          },
+          "latest_verification": {
+            "$ref": "#/components/schemas/LatestBlueprintVerification"
+          },
+          "ignored_resource_addresses": {
+            "type": "array",
+            "description": "Resource addresses excluded during the latest install/update and ignored by verification.",
+            "items": {
+              "type": "string"
+            }
+          },
+          "installation_status": {
+            "type": "string",
+            "enum": [
+              "IN_PROGRESS",
+              "CANCELED",
+              "PARTIAL",
+              "SUCCESS",
+              "FAILED"
+            ]
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "created_by": {
+            "$ref": "#/components/schemas/CallerIdentity"
+          },
+          "updated_by": {
+            "$ref": "#/components/schemas/CallerIdentity"
+          },
+          "installation_job_ids": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/BlueprintJobID"
+            }
+          },
+          "source_blueprint_id": {
+            "description": "ID of the blueprint that brought this blueprint to the destination org (deployed or installed)",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/BlueprintID"
+              }
+            ]
+          },
+          "archived": {
+            "type": "boolean",
+            "description": "Whether the blueprint is archived (soft-deleted). Archived blueprints are hidden from the main list.",
+            "default": false
+          },
+          "docs_url": {
+            "type": "string",
+            "description": "URL to the blueprint documentation"
+          },
+          "recommended_apps": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "List of recommended app IDs for the blueprint"
+          },
+          "required_features": {
+            "type": "object",
+            "description": "Feature constraints for blueprint installation",
+            "properties": {
+              "enabled": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Features that must be enabled in the target org"
+              },
+              "disabled": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Features that must be disabled in the target org"
+              }
+            }
+          },
+          "zip_file_name": {
+            "type": "string",
+            "description": "Custom name for the exported zip file"
+          }
+        },
         "required": [
           "title"
         ]
@@ -2150,6 +2906,23 @@
               "type": "string"
             }
           },
+          "required_features": {
+            "type": "object",
+            "properties": {
+              "enabled": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "disabled": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          },
           "created_at": {
             "type": "string",
             "format": "date-time"
@@ -2197,7 +2970,9 @@
               },
               "source_type": {
                 "type": "string",
-                "const": "custom"
+                "enum": [
+                  "custom"
+                ]
               }
             }
           }
@@ -2216,7 +2991,9 @@
             "properties": {
               "source_type": {
                 "type": "string",
-                "const": "file"
+                "enum": [
+                  "file"
+                ]
               },
               "resources": {
                 "type": "array",
@@ -2245,7 +3022,9 @@
               },
               "source_type": {
                 "type": "string",
-                "const": "marketplace"
+                "enum": [
+                  "marketplace"
+                ]
               },
               "resources": {
                 "type": "array",
@@ -2341,7 +3120,9 @@
             "properties": {
               "source_type": {
                 "type": "string",
-                "const": "deploy"
+                "enum": [
+                  "deploy"
+                ]
               },
               "resources": {
                 "type": "array",
@@ -2366,7 +3147,9 @@
             "properties": {
               "source_type": {
                 "type": "string",
-                "const": "app"
+                "enum": [
+                  "app"
+                ]
               },
               "resources": {
                 "type": "array",
@@ -2497,6 +3280,7 @@
                   "WAITING_USER_ACTION",
                   "CANCELED",
                   "SUCCESS",
+                  "PARTIAL_SUCCESS",
                   "FAILED"
                 ]
               }
@@ -2517,6 +3301,9 @@
           },
           {
             "$ref": "#/components/schemas/BlueprintValidateJob"
+          },
+          {
+            "$ref": "#/components/schemas/BlueprintVerificationJob"
           }
         ]
       },
@@ -2576,7 +3363,162 @@
               }
             }
           }
-        ]
+        ]
+      },
+      "BlueprintVerificationJob": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CommonBlueprintJobFields"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "source_org_id": {
+                "type": "string"
+              },
+              "source_blueprint_id": {
+                "$ref": "#/components/schemas/BlueprintID"
+              },
+              "destination_org_id": {
+                "type": "string"
+              },
+              "destination_blueprint_id": {
+                "$ref": "#/components/schemas/BlueprintID"
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "IN_PROGRESS",
+                  "SUCCESS",
+                  "FAILED"
+                ]
+              },
+              "summary": {
+                "$ref": "#/components/schemas/VerificationSummary"
+              },
+              "resource_results": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/ResourceVerificationResult"
+                }
+              },
+              "resource_results_s3_key": {
+                "type": "string",
+                "description": "S3 key for detailed results when too large for inline storage."
+              }
+            }
+          }
+        ]
+      },
+      "LatestBlueprintVerification": {
+        "type": "object",
+        "properties": {
+          "job_id": {
+            "$ref": "#/components/schemas/BlueprintJobID"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "IN_PROGRESS",
+              "SUCCESS",
+              "FAILED"
+            ]
+          },
+          "triggered_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "source_org_id": {
+            "type": "string"
+          },
+          "source_blueprint_id": {
+            "$ref": "#/components/schemas/BlueprintID"
+          },
+          "destination_org_id": {
+            "type": "string"
+          },
+          "destination_blueprint_id": {
+            "$ref": "#/components/schemas/BlueprintID"
+          },
+          "summary": {
+            "$ref": "#/components/schemas/VerificationSummary"
+          }
+        }
+      },
+      "VerificationSummary": {
+        "type": "object",
+        "properties": {
+          "total_resources": {
+            "type": "integer"
+          },
+          "matched": {
+            "type": "integer"
+          },
+          "mismatched": {
+            "type": "integer"
+          },
+          "missing_in_destination": {
+            "type": "integer"
+          },
+          "fetch_errors": {
+            "type": "integer"
+          }
+        }
+      },
+      "ResourceVerificationResult": {
+        "type": "object",
+        "properties": {
+          "resource_type": {
+            "$ref": "#/components/schemas/ResourceNodeType"
+          },
+          "resource_name": {
+            "type": "string"
+          },
+          "source_resource_id": {
+            "type": "string"
+          },
+          "destination_resource_id": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "matched",
+              "mismatched",
+              "missing_in_destination",
+              "fetch_error"
+            ]
+          },
+          "field_diffs": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/FieldDiff"
+            }
+          },
+          "error": {
+            "type": "string"
+          }
+        }
+      },
+      "FieldDiff": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "JSON path to the differing field (e.g. \"steps[2].name\")"
+          },
+          "source_value": {},
+          "destination_value": {},
+          "diff_type": {
+            "type": "string",
+            "enum": [
+              "value_changed",
+              "field_missing_in_destination",
+              "field_missing_in_source",
+              "type_mismatch"
+            ]
+          }
+        }
       },
       "BlueprintJobEvent": {
         "type": "object",
@@ -2705,6 +3647,7 @@
           "CANCELED",
           "IN_PROGRESS",
           "SUCCESS",
+          "PARTIAL_SUCCESS",
           "FAILED"
         ]
       },
@@ -2745,7 +3688,8 @@
           "validation_rule",
           "flow_template",
           "taxonomy",
-          "notification_template"
+          "notification_template",
+          "environment_variable"
         ]
       },
       "PlanChanges": {
@@ -3465,6 +4409,418 @@
             }
           }
         }
+      },
+      "MarketplaceListing": {
+        "type": "object",
+        "required": [
+          "id",
+          "blueprint_id",
+          "name",
+          "slug",
+          "status"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "blueprint_id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "slug": {
+            "type": "string"
+          },
+          "logo": {
+            "type": "string",
+            "nullable": true
+          },
+          "documentation_url": {
+            "type": "string",
+            "nullable": true
+          },
+          "pricing_type": {
+            "type": "string",
+            "enum": [
+              "free",
+              "paid",
+              "freemium",
+              "contact_us"
+            ],
+            "nullable": true
+          },
+          "support_email": {
+            "type": "string",
+            "nullable": true
+          },
+          "portal_description": {
+            "type": "string",
+            "nullable": true
+          },
+          "teaser_name": {
+            "type": "string",
+            "nullable": true
+          },
+          "teaser_short_description": {
+            "type": "string",
+            "nullable": true
+          },
+          "teaser_thumbnail": {
+            "type": "string",
+            "nullable": true
+          },
+          "details_page_title": {
+            "type": "string",
+            "nullable": true
+          },
+          "details_page_description": {
+            "type": "string",
+            "nullable": true
+          },
+          "details_page_hero_image": {
+            "type": "string",
+            "nullable": true
+          },
+          "details_page_carousel": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "resources_section_description": {
+            "type": "string",
+            "nullable": true
+          },
+          "resources_section_benefits_title": {
+            "type": "string",
+            "nullable": true
+          },
+          "resources_section_benefits_list": {
+            "type": "string",
+            "nullable": true
+          },
+          "resources_section_process_details": {
+            "type": "string",
+            "nullable": true
+          },
+          "partner": {
+            "type": "string",
+            "nullable": true
+          },
+          "partner_subtext": {
+            "type": "string",
+            "nullable": true
+          },
+          "partner_logo": {
+            "type": "string",
+            "nullable": true
+          },
+          "partner_website_link": {
+            "type": "string",
+            "nullable": true
+          },
+          "last_updated_on": {
+            "type": "string",
+            "nullable": true
+          },
+          "requires_customer_portal": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "process_details_section_title": {
+            "type": "string",
+            "nullable": true
+          },
+          "is_new_blueprint": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "available_in": {
+            "type": "string",
+            "nullable": true
+          },
+          "testimonials": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "installation_link": {
+            "type": "string",
+            "nullable": true
+          },
+          "installation_slug": {
+            "type": "string",
+            "nullable": true
+          },
+          "demo_form_link": {
+            "type": "string",
+            "nullable": true
+          },
+          "order": {
+            "type": "number",
+            "nullable": true
+          },
+          "categories": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "main_category": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "draft",
+              "live",
+              "archived"
+            ]
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "MarketplaceListingUpdate": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "slug": {
+            "type": "string"
+          },
+          "logo": {
+            "type": "string",
+            "nullable": true
+          },
+          "documentation_url": {
+            "type": "string",
+            "nullable": true
+          },
+          "pricing_type": {
+            "type": "string",
+            "enum": [
+              "free",
+              "paid",
+              "freemium",
+              "contact_us"
+            ],
+            "nullable": true
+          },
+          "support_email": {
+            "type": "string",
+            "nullable": true
+          },
+          "portal_description": {
+            "type": "string",
+            "nullable": true
+          },
+          "teaser_name": {
+            "type": "string",
+            "nullable": true
+          },
+          "teaser_short_description": {
+            "type": "string",
+            "nullable": true
+          },
+          "teaser_thumbnail": {
+            "type": "string",
+            "nullable": true
+          },
+          "details_page_title": {
+            "type": "string",
+            "nullable": true
+          },
+          "details_page_description": {
+            "type": "string",
+            "nullable": true
+          },
+          "details_page_hero_image": {
+            "type": "string",
+            "nullable": true
+          },
+          "details_page_carousel": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "resources_section_description": {
+            "type": "string",
+            "nullable": true
+          },
+          "resources_section_benefits_title": {
+            "type": "string",
+            "nullable": true
+          },
+          "resources_section_benefits_list": {
+            "type": "string",
+            "nullable": true
+          },
+          "resources_section_process_details": {
+            "type": "string",
+            "nullable": true
+          },
+          "partner": {
+            "type": "string",
+            "nullable": true
+          },
+          "partner_subtext": {
+            "type": "string",
+            "nullable": true
+          },
+          "partner_logo": {
+            "type": "string",
+            "nullable": true
+          },
+          "partner_website_link": {
+            "type": "string",
+            "nullable": true
+          },
+          "last_updated_on": {
+            "type": "string",
+            "nullable": true
+          },
+          "requires_customer_portal": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "process_details_section_title": {
+            "type": "string",
+            "nullable": true
+          },
+          "is_new_blueprint": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "available_in": {
+            "type": "string",
+            "nullable": true
+          },
+          "testimonials": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "installation_link": {
+            "type": "string",
+            "nullable": true
+          },
+          "installation_slug": {
+            "type": "string",
+            "nullable": true
+          },
+          "demo_form_link": {
+            "type": "string",
+            "nullable": true
+          },
+          "order": {
+            "type": "number",
+            "nullable": true
+          },
+          "categories": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "main_category": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        }
+      },
+      "MarketplaceListingVersion": {
+        "type": "object",
+        "required": [
+          "id",
+          "listing_id",
+          "status",
+          "draft_label",
+          "created_at"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "listing_id": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "draft",
+              "published",
+              "archived"
+            ]
+          },
+          "version_name": {
+            "type": "string",
+            "nullable": true
+          },
+          "draft_label": {
+            "type": "string"
+          },
+          "update_note": {
+            "type": "string",
+            "nullable": true
+          },
+          "resources": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            },
+            "nullable": true
+          },
+          "required_features": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "recommended_apps": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "published_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        }
       }
     },
     "parameters": {