CLI

# hotcfg schedules

List a bin's scheduled promotes, and cancel one.

usage

```
hotcfg schedules list <bin_id> [--json]
hotcfg schedules cancel <bin_id> <schedule_id>
```

Promotes are scheduled with [`hotcfg promote --at`](https://hotcfg.run/docs/cli/promote#schedule-it). These commands show and cancel them. Needs CLI 0.5.0 or later and a secret key.

terminal

```
$ hotcfg schedules list game-config
ID                    PROMOTE                     AT                REVERT AT         STATE                               BY
sch_4f1c2a9e7b30d851  staging v14 → production    2026-11-21 19:00  2026-11-24 07:00  waiting                             Ada
sch_0b7e51c4d2a9f366  staging v12 → production    2026-11-14 19:00  2026-11-17 07:00  promoted as v31, reverted as v32    Ada
```

Waiting schedules come first, soonest first, then the most recent others. For a failed schedule, or a skipped revert, the reason follows the table.

terminal

```
$ hotcfg schedules cancel game-config sch_4f1c2a9e7b30d851
✓ Cancelled sch_4f1c2a9e7b30d851 on game-config
```

Cancelling before the promote drops the whole schedule; after it, only the revert. A schedule that has finished can't be cancelled (`409 schedule_finished`). See [Scheduled promotes](https://hotcfg.run/docs/guides/scheduling).

Last updated 17 November 2026
