Merge pull request #6 from StackVista/stac-23211

Stac 23211

Author: aacevedoosorio

spec/openapi.yaml

@@ -35,6 +35,7 @@ paths:
   /stackpack/{stackPackName}/provision: { $ref: "stackpack.xapi.yaml#/paths/%2Fstackpack%2F%7BstackPackName%7D%2Fprovision" }
   /stackpack/{stackPackName}/deprovision/{stackPackInstanceId}: { $ref: "stackpack.xapi.yaml#/paths/%2Fstackpack%2F%7BstackPackName%7D%2Fdeprovision%2F%7BstackPackInstanceId%7D" }
   /stackpack/{stackPackName}/upgrade: { $ref: "stackpack.xapi.yaml#/paths/%2Fstackpack%2F%7BstackPackName%7D%2Fupgrade" }
+  /stackpack/{stackPackName}/downgrade: { $ref: "stackpack.xapi.yaml#/paths/%2Fstackpack%2F%7BstackPackName%7D%2Fdowngrade" }
   /stackpack/{stackPackName}/versions: { $ref: "stackpack.xapi.yaml#/paths/%2Fstackpack%2F%7BstackPackName%7D%2Fversions" }
   /stackpack/{stackPackName}/versions/{version}: { $ref: "stackpack.xapi.yaml#/paths/%2Fstackpack%2F%7BstackPackName%7D%2Fversions%2F%7Bversion%7D" }
   /stackpack/{stackPackName}/confirm-manual-steps/{stackPackInstanceId}: {$ref: "stackpack.xapi.yaml#/paths/%2Fstackpack%2F%7BstackPackName%7D%2Fconfirm-manual-steps%2F%7BstackPackInstanceId%7D"}

spec/stackpack.xapi.yaml

@@ -97,6 +97,7 @@ paths:
           required: true
           schema:
             type: string
+        - $ref: "#/components/parameters/stackPackVersion"
       summary: "Provision API"
       operationId: provisionDetails
       description: "Provision details"
@@ -168,6 +169,26 @@ paths:
                 type: string
         "500":
           $ref: "generic_error_handling.xapi.yaml#/components/responses/genericErrorsResponse"
+
+  /stackpack/{stackPackName}/downgrade:
+    post:
+      tags:
+        - stackpack
+      parameters:
+        - $ref: "#/components/parameters/stackPackName"
+        - $ref: "#/components/parameters/requiredStackPackVersion"
+      summary: "Downgrade API"
+      operationId: downgradeStackPack
+      description: "Downgrade a StackPack to an older version. Only supported for StackPacks 2.0; the target version must be lower than the currently installed version."
+      responses:
+        "200":
+          description: "successful"
+          content:
+            application/json:
+              schema:
+                type: string
+        "500":
+          $ref: "generic_error_handling.xapi.yaml#/components/responses/genericErrorsResponse"
   /stackpack/{stackPackName}/versions:
     get:
       tags:
@@ -338,7 +359,14 @@ components:
       required: false
       schema:
         type: string
-      description: "Optional version string (e.g. '1.2.3'). If not provided, validates the latest version."
+      description: "Optional version string (e.g. '1.2.3'). If not provided, the latest version is used. When provisioning, the StackPack cannot already be installed at a different version."
+    requiredStackPackVersion:
+      in: query
+      name: version
+      required: true
+      schema:
+        type: string
+      description: "Version string (e.g. '1.2.3') to downgrade to. Must be lower than the currently installed version."
     version:
       in: path
       name: version