Block: Schedule Block — Zelaxy Docs

The Schedule block starts a workflow automatically on a recurring timetable. Use it to run workflows at fixed intervals or specific times — minutes, hourly, daily, weekly, monthly, or with a custom cron expression — without any manual or external trigger.

Overview

Property	Value
Type	`schedule`
Category	triggers
Color	`#7B68EE`

When to Use

Run a workflow every X minutes for frequent polling or sync tasks
Send a daily report or digest at a fixed time of day
Execute weekly jobs on a chosen day (e.g. Monday morning summaries)
Run monthly billing, cleanup, or rollup workflows on a set day
Drive any recurring automation with a custom cron expression for full control
Pin execution to a specific timezone so timed runs fire when you expect

Configuration

Schedule Status

Displays the current schedule configuration and status. The schedule itself is configured through the modal opened from this status display.

Frequency (`scheduleType`)

Dropdown selecting how often the workflow runs. Defaults to daily. Options:

Label	id
Every X Minutes	`minutes`
Hourly	`hourly`
Daily	`daily`
Weekly	`weekly`
Monthly	`monthly`
Custom Cron	`custom`

Timing Fields

Depending on the selected frequency, you set the relevant timing field(s):

Frequency	Field(s)	Description
`minutes`	`minutesInterval`	Interval in minutes between runs
`hourly`	`hourlyMinute`	Minute past the hour to fire (e.g. `15` for :15)
`daily`	`dailyTime`	Time of day in HH:MM format (e.g. `09:00`)
`weekly`	`weeklyDay` + `weeklyDayTime`	Day of week + time of day
`monthly`	`monthlyDay` + `monthlyTime`	Day of month (1–31) + time of day
`custom`	`cronExpression`	Full cron expression (e.g. `0 9 * * MON-FRI`)

Weekly Day (`weeklyDay`)

Dropdown selecting the day of week. Options:

Label	id
Monday	`MON`
Tuesday	`TUE`
Wednesday	`WED`
Thursday	`THU`
Friday	`FRI`
Saturday	`SAT`
Sunday	`SUN`

Defaults to MON.

Timezone (`timezone`)

Dropdown anchoring the schedule to a timezone. Defaults to UTC. Options:

Label	id
UTC	`UTC`
US Eastern (UTC-4)	`America/New_York`
US Central (UTC-5)	`America/Chicago`
US Mountain (UTC-6)	`America/Denver`
US Pacific (UTC-7)	`America/Los_Angeles`
London (UTC+1)	`Europe/London`
Paris (UTC+2)	`Europe/Paris`
Singapore (UTC+8)	`Asia/Singapore`
Tokyo (UTC+9)	`Asia/Tokyo`
Sydney (UTC+10)	`Australia/Sydney`

Inputs & Outputs

Inputs: none — the Schedule block initiates workflows and takes no inputs.
Outputs: none — the Schedule block starts workflow execution and produces no direct outputs.

Tools

The Schedule block does not call any external tools. It is a trigger-only block that initiates workflow execution on a timetable; all scheduling logic is handled internally by the platform.

YAML Example

As a trigger, the Schedule block has no incoming connection; it only connects outward to the first block of the workflow.

schedule_1:
  type: schedule
  name: "Schedule"
  inputs:
    scheduleType: "daily"
    dailyTime: "09:00"
    timezone: "UTC"
  connections:
    outgoing:
      - target: agent_1

Schedule Block