OpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-148243531000.1 KB

5f7e0c3a8f59

schedule

create schedule

post/w/{workspace}/schedules/create

Path parameters

workspacestring required

Request body

pathstring required

The unique Windmill path for this schedule. Must be of the form u/<user>/<path> or f/<folder>/<path>.

schedulestring required

Cron expression with 6 fields (seconds, minutes, hours, day of month, month, day of week). Example '0 0 12 * * *' for daily at noon

timezonestring required

IANA timezone for the schedule (e.g., 'UTC', 'Europe/Paris', 'America/New_York')

script_pathstring required

Path to the script or flow to execute when triggered

is_flowboolean required

True if script_path points to a flow, false if it points to a script

argsScriptArgs required

The arguments to pass to the script or flow

enabledboolean

Whether the schedule is currently active and will trigger jobs

on_failurestring nullable

Path to a script or flow to run when the scheduled job fails

on_failure_timesnumber nullable

Number of consecutive failures before the on_failure handler is triggered (default 1)

on_failure_exactboolean nullable

If true, trigger on_failure handler only on exactly N failures, not on every failure after N

on_failure_extra_argsScriptArgs

The arguments to pass to the script or flow

on_recoverystring nullable

Path to a script or flow to run when the schedule recovers after failures

on_recovery_timesnumber nullable

Number of consecutive successes before the on_recovery handler is triggered (default 1)

on_recovery_extra_argsScriptArgs

The arguments to pass to the script or flow

on_successstring nullable

Path to a script or flow to run after each successful execution

on_success_extra_argsScriptArgs

The arguments to pass to the script or flow

ws_error_handler_mutedboolean

If true, the workspace-level error handler will not be triggered for this schedule's failures

retryRetry — unresolved $ref
no_flow_overlapboolean

If true, skip this schedule's execution if the previous run is still in progress (prevents concurrent runs)

summarystring nullable

Short summary describing the purpose of this schedule

descriptionstring nullable

Detailed description of what this schedule does

tagstring nullable

Worker tag to route jobs to specific worker groups

paused_untilstring date-time nullable

ISO 8601 datetime until which the schedule is paused. Schedule resumes automatically after this time

cron_versionstring nullable

Cron parser version. Use 'v2' for extended syntax with additional features

dynamic_skipstring nullable

Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean to skip (true) or run (false)

permissioned_asstring

The user or group this schedule runs as. Used during deployment to preserve the original schedule owner.

preserve_permissioned_asboolean

When true and the caller is a member of the 'wm_deployers' group, preserves the original permissioned_as value instead of overwriting it.

labelsstring[]

Response

schedule created