team-miscellaneous-branch-protections · Oct 16, 2026
diff --git a/src/pages/docs/cli/_generated/octopus-release-promote.mdx b/src/pages/docs/cli/_generated/octopus-release-promote.mdx
@@ -0,0 +1,61 @@
+---
+layout: src/layouts/Cli.astro
+pubDate: 2023-01-01
+modDate: 2026-10-16
+title: octopus release promote
+description: Promote a release
+navOrder: 128
+---
+import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
+
+Promote a release to a specific environment
+
+```text
+Usage:
+  octopus release promote [flags]
+
+Flags:
+      --deploy-at string                           Deploy at a later time. Deploy now if omitted. TODO date formats and timezones!
+      --deploy-at-expiry string                    Cancel the deployment if it hasn't started within this time period.
+      --deployment-freeze-name stringArray         Override this deployment freeze (can be specified multiple times)
+      --deployment-freeze-override-reason string   Reason for overriding a deployment freeze
+      --deployment-target stringArray              Deploy to this target (can be specified multiple times)
+      --exclude-deployment-target stringArray      Deploy to targets except for this (can be specified multiple times)
+      --excluded-target-tag stringArray            Deploy to targets except for those matching this tag (can be specified multiple times)
+      --force-package-download                     Force re-download of packages
+      --from string                                Name or ID of the environment to get the current deployment from
+      --guided-failure string                      Enable Guided failure mode (true/false/default)
+      --latest-successful                          Use the latest successful release to promote
+      --priority string                            Jump the task queue ahead of other queued tasks (true/false/default). Requires the Priority Tasks feature, and the TaskPrioritize permission to set true.
+  -p, --project string                             Name or ID of the project
+      --skip stringArray                           Exclude specific steps from the deployment
+      --specific-target-tag stringArray            Deploy to targets matching this tag (can be specified multiple times)
+      --tenant stringArray                         Deploy to this tenant (can be specified multiple times)
+      --tenant-tag stringArray                     Deploy to tenants matching this tag (can be specified multiple times). Format is 'Tag Set Name/Tag Name', such as 'Regions/South'.
+      --to stringArray                             Name or ID of the environment(s) to promote to
+      --update-variables                           Overwrite the release variable snapshot by re-importing variables from the project.
+  -v, --variable stringArray                       Set the value for a prompted variable in the format Label:Value
+
+
+Global Flags:
+  -h, --help                   Show help for a command
+      --no-prompt              Disable prompting in interactive mode
+  -f, --output-format string   Specify the output format for a command ("json", "table", or "basic") (default "table")
+  -s, --space string           Specify the space for operations
+
+```
+
+## Examples
+
+<SamplesInstance />
+
+```bash
+octopus release promote --project MyProject --from "Development" --to "Staging"\
+octopus release promote -p MyProject --from "Staging" --to "Production" --latest-successful\
+
+```
+
+## Learn more
+
+- [Octopus CLI](/docs/cli)
+- [Creating API keys](/docs/octopus-rest-api/how-to-create-an-api-key)
diff --git a/src/pages/docs/cli/_generated/octopus-release-snapshot-variables.mdx b/src/pages/docs/cli/_generated/octopus-release-snapshot-variables.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus release snapshot-variables
 description: Update the variable snapshot for a release
-navOrder: 128
+navOrder: 129
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 
@@ -32,8 +32,8 @@
 <SamplesInstance />

 ```bash
 $ octopus release snapshot-variables --project MyProject --version 1.2.3
 $ octopus release snapshot-variables -p MyProject -v 1.2.3


 ```

diff --git a/src/pages/docs/cli/_generated/octopus-release.mdx b/src/pages/docs/cli/_generated/octopus-release.mdx
@@ -1,7 +1,7 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus release
 description: Manage releases
 navOrder: 120
@@ -21,6 +21,7 @@ Available Commands:
   help Help about any command
   list List releases
   progression Manage progression of a release
+  promote Promote a release
   snapshot-variables Update the variable snapshot for a release
 
 Global Flags:

diff --git a/src/pages/docs/cli/_generated/octopus-runbook-delete.mdx b/src/pages/docs/cli/_generated/octopus-runbook-delete.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus runbook delete
 description: Delete a runbook
-navOrder: 130
+navOrder: 131
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-runbook-list.mdx b/src/pages/docs/cli/_generated/octopus-runbook-list.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus runbook list
 description: List runbooks
-navOrder: 131
+navOrder: 132
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-runbook-run.mdx b/src/pages/docs/cli/_generated/octopus-runbook-run.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus runbook run
 description: Run runbooks in Octopus Deploy
-navOrder: 132
+navOrder: 133
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-runbook-snapshot-create.mdx b/src/pages/docs/cli/_generated/octopus-runbook-snapshot-create.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus runbook snapshot create
 description: Create a runbook snapshot
-navOrder: 134
+navOrder: 135
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-runbook-snapshot-list.mdx b/src/pages/docs/cli/_generated/octopus-runbook-snapshot-list.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus runbook snapshot list
 description: List runbook snapshots
-navOrder: 135
+navOrder: 136
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-runbook-snapshot-publish.mdx b/src/pages/docs/cli/_generated/octopus-runbook-snapshot-publish.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus runbook snapshot publish
 description: Publish a runbook snapshot
-navOrder: 136
+navOrder: 137
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-runbook-snapshot-snapshot-variables.mdx b/src/pages/docs/cli/_generated/octopus-runbook-snapshot-snapshot-variables.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus runbook snapshot snapshot-variables
 description: Update the variable snapshot for a runbook snapshot
-navOrder: 137
+navOrder: 138
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 
@@ -33,8 +33,8 @@
 <SamplesInstance />

 ```bash
 $ octopus runbook snapshot snapshot-variables --project MyProject --runbook "Rebuild DB Indexes"
 $ octopus runbook snapshot snapshot-variables --project MyProject --runbook "Rebuild DB Indexes" --snapshot "Snapshot 40C9ENM"


 ```

diff --git a/src/pages/docs/cli/_generated/octopus-runbook-snapshot.mdx b/src/pages/docs/cli/_generated/octopus-runbook-snapshot.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus runbook snapshot
 description: Manage runbook snapshots
-navOrder: 133
+navOrder: 134
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-runbook.mdx b/src/pages/docs/cli/_generated/octopus-runbook.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus runbook
 description: Manage runbooks
-navOrder: 129
+navOrder: 130
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-space-create.mdx b/src/pages/docs/cli/_generated/octopus-space-create.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus space create
 description: Create a space
-navOrder: 139
+navOrder: 140
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-space-delete.mdx b/src/pages/docs/cli/_generated/octopus-space-delete.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus space delete
 description: Delete a space
-navOrder: 140
+navOrder: 141
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-space-list.mdx b/src/pages/docs/cli/_generated/octopus-space-list.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus space list
 description: List spaces
-navOrder: 141
+navOrder: 142
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-space-view.mdx b/src/pages/docs/cli/_generated/octopus-space-view.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus space view
 description: View a space
-navOrder: 142
+navOrder: 143
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-space.mdx b/src/pages/docs/cli/_generated/octopus-space.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-02
+modDate: 2026-10-16
 title: octopus space
 description: Manage spaces
-navOrder: 138
+navOrder: 139
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-task-list.mdx b/src/pages/docs/cli/_generated/octopus-task-list.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-14
+modDate: 2026-10-16
 title: octopus task list
 description: List tasks
-navOrder: 144
+navOrder: 145
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-task-wait.mdx b/src/pages/docs/cli/_generated/octopus-task-wait.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-14
+modDate: 2026-10-16
 title: octopus task wait
 description: Wait for task(s) to finish
-navOrder: 145
+navOrder: 146
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-task.mdx b/src/pages/docs/cli/_generated/octopus-task.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-14
+modDate: 2026-10-16
 title: octopus task
 description: Manage tasks
-navOrder: 143
+navOrder: 144
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-tenant-clone.mdx b/src/pages/docs/cli/_generated/octopus-tenant-clone.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-14
+modDate: 2026-10-16
 title: octopus tenant clone
 description: Clone a tenant
-navOrder: 147
+navOrder: 148
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-tenant-connect.mdx b/src/pages/docs/cli/_generated/octopus-tenant-connect.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-14
+modDate: 2026-10-16
 title: octopus tenant connect
 description: Connect a tenant to a project
-navOrder: 148
+navOrder: 149
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-tenant-create.mdx b/src/pages/docs/cli/_generated/octopus-tenant-create.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-14
+modDate: 2026-10-16
 title: octopus tenant create
 description: Create a tenant
-navOrder: 149
+navOrder: 150
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-tenant-delete.mdx b/src/pages/docs/cli/_generated/octopus-tenant-delete.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-14
+modDate: 2026-10-16
 title: octopus tenant delete
 description: Delete a tenant
-navOrder: 150
+navOrder: 151
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-tenant-disable.mdx b/src/pages/docs/cli/_generated/octopus-tenant-disable.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-14
+modDate: 2026-10-16
 title: octopus tenant disable
 description: Disable a tenant
-navOrder: 151
+navOrder: 152
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';
 

diff --git a/src/pages/docs/cli/_generated/octopus-tenant-disconnect.mdx b/src/pages/docs/cli/_generated/octopus-tenant-disconnect.mdx
@@ -1,10 +1,10 @@
 ---
 layout: src/layouts/Cli.astro
 pubDate: 2023-01-01
-modDate: 2026-10-14
+modDate: 2026-10-16
 title: octopus tenant disconnect
 description: Disconnect a tenant from a project
-navOrder: 152
+navOrder: 153
 ---
 import SamplesInstance from 'src/shared-content/samples/samples-instance.include.md';