CLI reference

Schedules

See and cancel runs that wait for a time.

schedule:list

List runs that wait for a time, soonest first.

needs API key
--json: full

synopsis

$ ignitify schedule:list

terminal

$ ignitify schedule:listschedule_id    sch_Rt6WnB3yKd8Qdeployment_id  019f3c24-1b05-7c9a-8e21-4d6f0b93a7e2task_name      image-resizefires_at       2027-01-15T03:00:00.000Zcreated_at     2026-10-14T09:12:03.540Z

More examples (1)

Nothing scheduled

$ ignitify schedule:listNo scheduled runs.Schedule one with: ignitify task:run <task-id> --at <iso>

terminal

$ ignitify schedule:list --json

--json

[
  {
    "schedule_id": "sch_Rt6WnB3yKd8Q",
    "deployment_id": "019f3c24-1b05-7c9a-8e21-4d6f0b93a7e2",
    "task_name": "image-resize",
    "fires_at": "2027-01-15T03:00:00.000Z",
    "created_at": "2026-10-14T09:12:03.540Z"
  }
]

schedule:cancel

Cancel one scheduled run so that it never fires.

needs API key
asks to confirm
deletes data
--json: full

synopsis

$ ignitify schedule:cancel <sch-id> [--yes]

terminal

$ ignitify schedule:cancel sch_Rt6WnB3yKd8QWill cancel schedule sch_Rt6WnB3yKd8Q — it will never fire.Proceed? [y/N] y✓ Schedule cancelled: sch_Rt6WnB3yKd8Q

terminal

$ ignitify schedule:cancel sch_Rt6WnB3yKd8Q --yes --json

--json

{
  "schedule_id": "sch_Rt6WnB3yKd8Q",
  "cancelled": true
}

Already fired

$ ignitify schedule:cancel sch_Rt6WnB3yKd8Q --yesWill cancel schedule sch_Rt6WnB3yKd8Q — it will never fire.Error: Schedule sch_Rt6WnB3yKd8Q was NOT cancelled: not found, already fired, or currently firing.

Flag	Value	Default	Description
`<sch-id>`required	—	—	The schedule id, from task:run --at or schedule:list.
`--yes, -y`	—	—	Skip the question.

What happens

Prints which schedule it will cancel.
Asks you to confirm, unless you pass --yes.
Cancels the schedule.
Prints the schedule id.