preview_schedule
Preview a schedule to verify its summary and zone breakdown before committing. Dry-run that returns the same schedule as create_schedule would produce without saving.
Instructions
Server-side dry-run of create_schedule. Does NOT persist anything.
Returns the same Schedule that create_schedule would produce,
including the server-generated human-readable summary like
'Every Monday and Thursday at 5:00 AM'. Always call this first and
verify the summary + zone breakdown before calling create_schedule.
Args:
name: Schedule display name, e.g. "Summer Lawn".
zones: List of zone entries. Each must be a dict with keys:
device_id (str), zone_id (str),
watering_time (int seconds), optionally
order_id (int, defaults to list position + 1),
flex_aggression_coefficient (float, flex only),
flex_runtime_coefficient (float, flex only).
schedule_type: FIXED (default), FLEX_MONTHLY, or FLEX_DAILY.
start_time: Daily start time HH:MM, e.g. "05:00". Use this for
fixed clock-time schedules.
start_sun: "SUNRISE" or "SUNSET" to anchor to solar time
instead of a clock time. Provide at most one of start_time
or start_sun.
days: Days of week for FIXED schedules, e.g. ["MON", "THU"].
Names accept MON/TUE/WED/THU/FRI/SAT/SUN (case-insensitive).
Omit for schedules that run every day within the date window.
annual_start: Recurring-yearly window start, MM-DD (e.g. "06-15"
for mid-June). Use for seasonal schedules.
annual_end: Recurring-yearly window end, MM-DD.
smart_cycle: Let Rachio auto-calculate cycle and soak based on
each zone's soil/slope/nozzle.
cycle_soak: Enable manual cycle + soak. Combine with
cycle_time_seconds and soak_time_seconds.
cycle_time_seconds: Length of each watering cycle (seconds).
soak_time_seconds: Rest interval between cycles (seconds).
zone_delay_time_seconds: Delay between zones in the sequence.
rain_delay_enabled: Skip runs after significant rain.
freeze_delay_enabled: Skip runs when temp drops below freezing.
wind_delay_enabled: Skip runs during high wind.
climate_skip: Skip runs when climate/ET data suggests enough
moisture is present.
seasonal_shift: Seasonally adjust runtimes up/down.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| name | Yes | ||
| zones | Yes | ||
| start_sun | No | ||
| annual_end | No | ||
| cycle_soak | No | ||
| start_time | No | ||
| smart_cycle | No | ||
| annual_start | No | ||
| climate_skip | No | ||
| schedule_type | No | FIXED | |
| seasonal_shift | No | ||
| soak_time_seconds | No | ||
| cycle_time_seconds | No | ||
| rain_delay_enabled | No | ||
| wind_delay_enabled | No | ||
| freeze_delay_enabled | No | ||
| zone_delay_time_seconds | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |