Schedules

Schedules allow you to automatically run tasks on a recurring cadence.

Creating Schedules

To create a schedule, you must have permissions to execute the task. You can manage schedules from individual task pages:

Schedules have a name and a human-friendly description. If the task has any parameters, you can specify parameter values when creating or editing a schedule.

Cron Syntax

The recurrence schedule is defined using cron syntax, with times specified in UTC. In addition to standard cron characters, Airplane supports the following:

Character

Valid Fields

Example

L

Day of Week

5L ("last Friday of the month")

#

Day of Week

5#3 ("third Friday of the month")

W

Day of Month

1W ("nearest weekday to the 1st of the month")

Sample Cron Expressions

Cron Expression

Meaning

0 12 * * *

Daily at 12:00 UTC

0 17 * * 5

Every Friday at 17:00 UTC

0 12 * * 3#1

First Wednesday of the month at 12:00 UTC

*/30 12-17 * * MON-FRI

Every half hour between 12:00 UTC and 16:59 UTC on weekdays

0 12 15 */2 *

Every 15th of the month at 12:00 UTC, every two months (starting in January)

Archiving Schedules

Schedules can be archived to temporarily or permanently prevent them from running. They may be unarchived at any time, as long as the task is also unarchived.

If a task is archived, all of its active schedules are also archived. Unarchiving a task does not automatically unarchive all of its associated schedules.

Invalid Schedules

It is possible for schedules to become invalid; e.g., adding required parameters to a task, or the schedule creator losing permissions to execute the task. In this case, the schedule will spawn failed runs until it is updated to add the new required parameter(s). If your schedule is spawning failed runs, check its parameter values.