feat: allow promoting an existing template version to active from CLI (#15051)

Co-authored-by: Muhammad Atif Ali <atif@coder.com>

docs/reference/cli/templates_versions.md

@@ -29,3 +29,4 @@ coder templates versions
 | [<code>list</code>](./templates_versions_list.md)           | List all the versions of the specified template |
 | [<code>archive</code>](./templates_versions_archive.md)     | Archive a template version(s).                  |
 | [<code>unarchive</code>](./templates_versions_unarchive.md) | Unarchive a template version(s).                |
+| [<code>promote</code>](./templates_versions_promote.md)     | Promote a template version to active.           |

docs/reference/cli/templates_versions_promote.md

@@ -0,0 +1,46 @@
+<!-- DO NOT EDIT | GENERATED CONTENT -->
+
+# templates versions promote
+
+Promote a template version to active.
+
+## Usage
+
+```console
+coder templates versions promote [flags] --template=<template_name> --template-version=<template_version_name>
+```
+
+## Description
+
+```console
+Promote an existing template version to be the active version for the specified template.
+```
+
+## Options
+
+### -t, --template
+
+|             |                                   |
+| ----------- | --------------------------------- |
+| Type        | <code>string</code>               |
+| Environment | <code>$CODER_TEMPLATE_NAME</code> |
+
+Specify the template name.
+
+### --template-version
+
+|             |                                           |
+| ----------- | ----------------------------------------- |
+| Type        | <code>string</code>                       |
+| Environment | <code>$CODER_TEMPLATE_VERSION_NAME</code> |
+
+Specify the template version name to promote.
+
+### -O, --org
+
+|             |                                  |
+| ----------- | -------------------------------- |
+| Type        | <code>string</code>              |
+| Environment | <code>$CODER_ORGANIZATION</code> |
+
+Select which organization (uuid or name) to use.