circleci deploy rollback

Introduced 2026-08-17 · score 0.97

HOW TO USE IT

When a CircleCI-managed deployment needs reverting, run `circleci deploy rollback` with the target version, component, and environment; provide the current version with `--from` if you need to assert which deployment is being replaced.

WHY THIS HELPS

Roll back a deployment managed through CircleCI.

REQUIREMENTS AND LIMITATIONS

• Version: v1.0.48275
• <target-version> (required): Version to roll back to.
• --component (required): Deploy component name or ID.
• --environment (required): Deploy environment name or ID.
• --from: Version being replaced; defaults to the latest deployed version.
• --force / -f: Skip the confirmation prompt.
• --namespace: Namespace scoping the component; defaults to `default`.
• --param: Rollback pipeline parameter in `key=value` form; repeatable.
• --reason: Reason for the rollback, recorded in the audit log.
• --project: Project slug; defaults to the current Git remote.
• --checkout-ref: Git ref the rollback pipeline checks out.
• --config-ref: Git ref from which the rollback pipeline config is read.
• Prerequisite: Install the CircleCI CLI.
• Prerequisite: For rollback through a rollback pipeline, configure deploy markers and a rollback pipeline for the project.

FIRST-PARTY EVIDENCE

• https://github.com/CircleCI-Public/circleci-cli/releases/tag/v1.0.48275
• https://cli.circleci.com/reference/
• https://circleci.com/docs/guides/deploy/rollback-a-deployment/

Check the installed version and the source before using it. Entry JSON

Report a problem with this card