Skip to Content
Docs are being rebuilt — start at Introduction → How it works.

Schedules

Schedules are automation jobs that run an agent immediately, once at a chosen time, or on a recurring cadence. In the app, they live under Automation on the Schedules tab.

What you can do here

  • Search scheduled jobs by title.
  • Filter schedules by status or assigned agent.
  • Create an immediate, one-time scheduled, or recurring schedule.
  • Run a schedule manually when it is active.
  • Review execution history in a side sheet.
  • Open the schedule detail page, edit the schedule, or delete it after confirmation.
Automation page on the Schedules tab showing search, status filter, agent filter, scheduled job rows, and New Schedule

List controls

ControlOptionsWhat it changes
Search schedulesFree textNarrows the list by schedule name.
Status filterAll Status, Active, Pending, PausedShows schedules with the selected status.
Agent filterAll Agents or one workspace agentShows schedules assigned to the selected agent.
New ScheduleButtonOpens the schedule creation dialog.
Schedules status filter menu showing All Status, Active, Pending, and Paused
Schedules agent filter menu showing All Agents and available workspace agents

Schedule rows

Row areaWhat it shows
TitleThe schedule name and execution type badge.
StatusCurrent state, such as Active, Pending, or Paused.
Next RunWhen the schedule is expected to run next.
Last RunMost recent run time, when available.
AgentThe agent assigned to execute the schedule.
ScheduleThe human-readable timing rule.
ActionsRun, execution history, and delete controls.

Click a row to open the schedule detail page.

How to create a schedule

  1. Open Automation from the sidebar.
  2. Click the Schedules tab.
  3. Click New Schedule.
  4. Enter Task Title.
  5. Select an AI Agent.
  6. Add Instructions for the agent.
  7. Choose When to Run.
  8. Fill in the timing fields required for that run type.
  9. Click Create Schedule.
New Schedule dialog with Task Title, AI Agent, Instructions, Generate AI Prompt, and Immediately selected
FieldRequiredWhat it controls
Task TitleYesNames the scheduled job in the Schedules list.
AI AgentYesChooses the agent that will perform the work.
InstructionsNoTells the agent what to do when the schedule runs.
Generate AI PromptNoDrafts instructions after a title and agent are selected.
When to RunYesChooses Immediately, Scheduled, or Recurring.

Agent picker

  1. Click AI Agent.
  2. Search or scroll through the available agents.
  3. Select the agent that should execute the schedule.
AI Agent picker in the New Schedule dialog showing searchable agent options

One-time scheduled run

Choose Scheduled when the job should run once in the future.

FieldRequiredWhat it controls
DateYesThe calendar date for the one-time run.
TimeYesThe local time for the one-time run.
New Schedule dialog with Scheduled selected and Date and Time fields visible

Recurring run

Choose Recurring when the job should repeat.

FieldOptionsWhat it controls
FrequencyMinutes, Hourly, Daily, Weekly, Monthly, CronThe cadence used for repeated runs.
IntervalNumber inputHow often the cadence repeats.
TimeTime inputThe run time for daily, weekly, and monthly schedules.
WeekdaySun through SatThe day used by weekly schedules.
CronCron expressionA custom schedule expression.
EndsNever, After N runs, On dateWhen the recurring schedule stops.
OccurrencesNumber inputThe run count used by After N runs.
End dateDate pickerThe stop date used by On date.
New Schedule dialog with Recurring selected and daily recurrence fields visible
Recurring schedule configured for Weekly with weekday chips visible
Recurring schedule configured for Cron with a custom cron expression field

Execution history

  1. Click the history action on a schedule row.
  2. Review total executions, successful executions, failed executions, and success rate.
  3. Expand a run to see timing, token usage, result, logs, and errors when available.
Execution History sheet for a scheduled job with summary cards and recent executions
Expanded scheduled job execution showing started time, finished time, duration, and token usage

Schedule detail page

Open a schedule row when you need the full record. The detail page shows the creator, update time, status, priority, execution type, run statistics, execution configuration, assigned AI agent, AI prompt, and recent runs.

Schedule detail page showing Execute Now, status badges, run statistics, execution configuration, assigned agent, AI prompt, and recent runs

Edit or delete a schedule

Use Edit Task on the detail page to reopen the schedule dialog with the current values. Use the row delete action or detail page delete action only when the schedule and its history should be removed.

Edit Schedule dialog with the same fields used when creating a schedule
Delete Task confirmation dialog warning that the scheduled job deletion cannot be undone