Automation

Scheduler System

Cron-based task scheduler for recurring workflows, background jobs, and time-triggered automations.

How the Scheduler Works

The Scheduler is a standalone service that evaluates cron expressions and triggers workflows at specified intervals. It runs independently of the main API server, ensuring reliable execution even during high load.

Cron Expressions

Define schedules using standard cron syntax (minute, hour, day, month, weekday).

Recurring Execution

Workflows are automatically queued and executed based on the schedule.

Timezone Support

All schedules respect the configured timezone for accurate triggering.

Creating a Scheduled Workflow

Attach a cron schedule to any workflow definition. The scheduler will automatically create execution instances at the specified times.

scheduled-workflow.json

{
  "name": "Daily Report Generator",
  "schedule": {
    "cron": "0 9 * * *",
    "timezone": "America/New_York",
    "enabled": true
  },
  "steps": [
    {
      "type": "agent",
      "prompt": "Generate a summary report of yesterday's activity."
    },
    {
      "type": "email",
      "to": "team@example.com",
      "subject": "Daily Report",
      "body": "{{steps[0].output}}"
    }
  ]
}

Common Cron Patterns

*/5 * * * *Every 5 minutes

0 * * * *Every hour at minute 0

0 9 * * *Every day at 9:00 AM

0 9 * * 1Every Monday at 9:00 AM

0 0 1 * *First day of every month at midnight

Scheduler Management

• View all active schedules via the API or dashboard
• Pause or resume schedules without deleting them
• Execution history is logged for audit and debugging
• Failed executions can trigger retry or alerting workflows