ctrlc api upsert version

The ctrlc api upsert version command creates or updates a deployment version in Ctrlplane. This is typically called from CI/CD pipelines after a successful build.

Usage

ctrlc api upsert version \
  --workspace <workspace> \
  --deployment <deployment-id> \
  --tag <version-tag> \
  [--name "<version-name>"] \
  [--metadata key=value ...]

Flags

Flag	Required	Description
`--workspace`	Yes	Workspace name or ID
`--deployment`	Yes	Deployment ID
`--tag`	Yes	Unique version identifier
`--name`	No	Human-readable version name
`--metadata`	No	Key-value metadata (repeatable)

Example

ctrlc api upsert version \
  --workspace my-workspace \
  --deployment dep_abc123 \
  --tag v1.2.3 \
  --name "Release 1.2.3" \
  --metadata git/commit=abc123 \
  --metadata git/branch=main

The command is idempotent — running it again with the same --tag updates the existing version rather than creating a duplicate.

Next Steps

CI/CD Integration

Full CI/CD setup guide

CLI Overview

All CLI commands

ctrlc apply Glossary & Reference

CLI

Concepts

RFCs

ctrlc api upsert version

Usage

Flags

Example

Next Steps

CI/CD Integration

CLI Overview

​Usage

​Flags

​Example

​Next Steps

CI/CD Integration

CLI Overview

Usage

Flags

Example

Next Steps