Guides

Run later

Start a run at a set time with --at. List the pending runs and cancel one with schedule:list and schedule:cancel.

1 · Schedule the run

Give --at a future time in ISO-8601, in UTC when it ends with Z.

terminal

$ ignitify task:run hello --at 2027-01-15T03:00:00ZScheduled: sch_Wk4RtZ9pXe1B fires at 2027-01-15T03:00:00.000ZNo run exists until it fires. List with 'ignitify schedule:list'; cancel with 'ignitify schedule:cancel sch_Wk4RtZ9pXe1B'.

2 · List the pending runs

schedule:list shows each pending schedule, soonest first.

terminal

$ ignitify schedule:listschedule_id    sch_Wk4RtZ9pXe1Bdeployment_id  019fdec3-0d12-7a58-8c47-2e9b6f1a3d70task_name      hellofires_at       2027-01-15T03:00:00.000Zcreated_at     2026-10-14T18:52:18.477Z

3 · Cancel one

schedule:cancel asks first; -y skips the question, and a script needs it.

terminal

$ ignitify schedule:cancel sch_Wk4RtZ9pXe1B -yWill cancel schedule sch_Wk4RtZ9pXe1B — it will never fire.Schedule cancelled: sch_Wk4RtZ9pXe1B

4 · Do not combine it with --wait

A scheduled run has no run id until it fires, so the CLI refuses --at with --wait.

terminal

$ ignitify task:run hello --at 2027-01-15T03:00:00Z --waitError: --wait cannot be used with --at: a scheduled run has no run id until it fires. Drop --wait; follow it later with 'ignitify schedule:list' and 'ignitify run:list'.

5 · Find the run after it fires

When the time comes, the schedule leaves the list and the run shows up in run:list.

terminal

$ ignitify run:list --task-name hello