CLI

# hotcfg rollback

Make an earlier version current again, as a new version.

usage

```
hotcfg rollback <bin_id> --to <version> [--env <env>]
```

Publishes the contents of an earlier version as the next version. History is never rewritten: the bad version stays in the list, and you can roll forward again the same way.

terminal

```
$ hotcfg rollback mobile-flags --env production --to 3
✓ Rolled back mobile-flags (production) to v3
  version  v5 (new revision with the contents of v3)
  hash     1a4cdd68925aa94d241b0cfc1aa2e40248c8476abc9602379ee69bbd82f56ac2
  cache    edge purge queued for production
```

## Flags

| Flag | Default | Description |
| --- | --- | --- |
| `--to` | required | The version to restore: `3` or `v3`. |
| `--env` | `production` | The environment. |

The old version is checked against the bin's current schema first. A version beyond your plan's history limit has been deleted and answers `404 version_pruned`. Rollback also republishes an [unpublished](https://hotcfg.run/docs/cli/unpublish) environment.

Last updated 5 November 2026
