hotcfg rollout

Change the share of a progressive rollout, complete it or abort it.

usage
hotcfg rollout <bin_id> [--env <env>] (--percent <1-99> | --complete | --abort)

Changes a progressive rollout that hotcfg promote --percent started. Each change purges the environment's edge cache.

terminal
$ hotcfg rollout mobile-flags --percent 50
✓ Rolling out mobile-flags production v13 to 50%; the rest get v12
  cache    edge purge queued for production

$ hotcfg rollout mobile-flags --complete
✓ Rollout completed: mobile-flags production is now v13 for everyone (was v12)
  cache    edge purge queued for production

Needs CLI 0.4.0 or later and a secret key that can write the environment.

Flags

Give exactly one of --percent, --complete or --abort.

FlagDefaultDescription
--envproductionThe environment with the rollout.
--percentGive the new version to this share of readers, from 1 to 99: apps that send ?bucket= below it.
--completeoffGive the new version to everyone. It becomes the environment's current version.
--abortoffGive everyone the current version again. The new version stays in history.
--jsonoffPrint the API's response as JSON.

With no rollout running, it fails with no rollout running (HTTP 409).

Last updated 17 November 2026