Schedules

Komodo can run Procedures and Actions automatically on a configured schedule.

Configuration

Add scheduling fields to any Procedure or Action:

[[procedure]]
name = "nightly-backup"
[procedure.config]
schedule_format = "English"
schedule = "Every day at 03:00"
schedule_enabled = true
schedule_timezone = "America/New_York"
schedule_alert = true
failure_alert = true

Schedule fields

Field	Description	Default
schedule_format	English for natural language, or Cron for cron expressions.	English
schedule	The schedule expression (see formats below).	""
schedule_enabled	Whether the schedule is active.	true
schedule_timezone	TZ identifier (e.g. America/New_York). Uses Core's timezone if empty.	""
schedule_alert	Send an alert each time the schedule runs.	true
failure_alert	Send an alert when a scheduled run fails.	true

Schedule formats

English (natural language)

Set schedule_format = "English" and write the schedule as a sentence:

• Every day at 03:00
• Every 5 minutes
• At midnight on the 1st and 15th of the month
• Every Monday at 09:00

Komodo converts these to cron expressions internally using the english-to-cron crate.

Cron

Set schedule_format = "Cron" and provide a 6-field cron expression (seconds are required):

second  minute  hour  day  month  day-of-week

Examples:

Expression	Meaning
0 0 3 * * ?	Every day at 03:00:00
0 */5 * * * ?	Every 5 minutes
0 0 0 1,15 * ?	At midnight on the 1st and 15th
0 0 9 ? * MON	Every Monday at 09:00

Viewing schedules

The ListSchedules API endpoint returns all configured schedules with their status, including:

• Last run time
• Next scheduled run time
• Any schedule parse errors

Alerts

When schedule_alert is enabled, Komodo sends an alert through your configured Alerters each time a scheduled Procedure or Action runs. If failure_alert is enabled, an additional alert is sent when the run fails.