Skip to main content

Schedule

Schedule lists the activities that run on their own, on a timer, for your organization. Each one is a cron: an activity, such as Runner, and a schedule that says when it fires. A Runner cron files a task each time it fires, so work that recurs — a weekly report, a dependency update — happens without anyone starting it.

Open it from the sidebar: select Automation, then the Schedule tab.

Schedule is shown only to Owners and Admins of your organization. Everyone else sees only the Playbooks tab. See Playbooks.

For the steps, see Create an automation schedule and Run, pause or change a schedule.

The list​

The Schedule tab: the tree view and + buttons, the Search box, and six crons, each with its name, the activity Runner, the kind cron, its schedule, its next firing and — never run

ItemWhat it does
Tree view buttonSwitches between a flat list and a tree. In the tree, names that use / are grouped as folders.
+ (New schedule)Opens the New cron form.
SearchNarrows the list to schedules whose name or activity contains what you type.

Your search and your view stay as you left them the next time you open the tab.

Each row is one cron. Select it to open its page.

ColumnMeaning
Mark● enabled, ○ disabled. A warning mark means it's overdue or stuck; hover it for why.
NameThe cron's name.
ActivityWhat it does each time it fires, such as Runner.
Kindcron for named times, interval for a fixed interval.
ScheduleWhen it fires, in words.
Next fireWhen it fires next.
Last runWhen it last fired, or — never run.

Empty states​

MessageMeaning
No crons yetYour organization has no scheduled activities. Select + to add one.
Nothing matches these filtersNo schedule matches your search. Select Clear filters to see them all.
Cron list unavailableThe list couldn't be read. Nothing was changed. Select Retry.

New cron​

The New cron form: Activity Runner, Name, Description, the Schedule line with Edit, Instructions, Projects, Persona Coder, Model Inherit, Hidden task, Full auto, Enabled, Keep logs All, and Create cron

FieldWhat it means
ActivityWhat the cron does when it fires. Runner files a task for a runner. The fields below it depend on the activity.
NameThe cron's name in the list. Use / to group crons into folders in the tree view.
DescriptionOptional. What the cron is for.
ScheduleWhen it fires, in words and as a cron expression, with the next firing. Select Edit to change it. See The schedule editor.
InstructionsRequired. Becomes the description of the task each firing files.
ProjectsThe projects to work on. Each firing files one task per project.
PersonaRequired. The kind of expert the task runs as. Coder is the default.
ModelThe model level. Inherit uses the persona's or project's default.
Hidden taskKeeps the tasks it files off the default task board.
Full autoThe runner never asks you anything; anything only a person could decide makes the task fail instead. On by default.
EnabledOff: nothing fires, but the schedule is kept.
Keep logsWhich firings are recorded on the Runs tab. See below.

Hover a field's label for a short explanation. Select Create cron to save it. Its page opens.

Keep logsRecords
AllEvery firing. The default.
When it actedSkips firings that found no work.
Errors onlyOnly failures and unexpected skips.

The schedule editor​

The schedule editor open: Schedule as A cron expression, and the Cron expression builder with Period day, hour 9 and minute 0, and Done

ItemWhat it does
Schedule asA cron expression fires at named times, in the time zone shown beside the next firing. A fixed interval fires every so many seconds, minutes or hours.
Cron expression builderPick a Period (such as day or week) and the times within it. The expression above it changes as you pick.
Every, UnitFor a fixed interval: the number and seconds, minutes or hours. The number must divide its unit evenly.
DoneCloses the editor. The Schedule line shows the new schedule and its next firing.

A cron's page​

At the top are the cron's name, whether it's Enabled, its activity, and Run now, which fires it once straight away. Run now is unavailable while the cron is disabled. After you select it, the page says Fired. The outcome lands on the Runs tab., or Not fired. and why.

Settings​

A cron's Settings tab: the name Documentation hygiene, Enabled, Run now, the tabs Settings, Runs and Advanced, then Name, Description, Enabled, Schedule, Instructions, Projects, Persona, Model and Save

The same fields as New cron, except those on Advanced. Change them and select Save. If you leave with unsaved changes, the page asks first.

Runs​

The Runs tab with No firings recorded: Nothing fired yet, or the history was swept.

Each firing the cron has recorded, newest first: when it fired, its outcome, and the task it filed. In the menu on each row, select Open firing to see This firing: when it fired, started and finished, its delay and duration. Select Load older firings for more. Which firings are recorded depends on Keep logs.

Advanced​

The Advanced tab: Hidden task, Full auto, Keep logs All, the facts Next fire, Last run, Created by, Created, Updated by and Updated, Save, and the Danger zone with Delete cron

ItemWhat it shows
Hidden task, Full auto, Keep logsAs on New cron. Select Save to keep a change.
Next fireWhen it fires next.
Last runWhen it last fired, or — never run.
Created by, Created, Updated by, UpdatedWho made the cron and last changed it, and when.
Delete cronIn Danger zone. Deletes the cron and every firing it recorded. It asks you to confirm and can't be undone.

To pause a cron without deleting it, turn off Enabled on Settings.