ScheduleDefinitionOutput

June 19, 2026 ยท View on GitHub

Output representation of a schedule with required schedule_id.

Used when returning schedules from the API where schedule_id is always present.

Fields

FieldTypeRequiredDescription
inputAny:heavy_check_mark:Input to provide to the workflow when starting it.
calendarsList[models.ScheduleCalendar]:heavy_minus_sign:Calendar-based specification of times.
intervalsList[models.ScheduleInterval]:heavy_minus_sign:Interval-based specification of times.
cron_expressionsList[str]:heavy_minus_sign:Cron-based specification of times.
skipList[models.ScheduleCalendar]:heavy_minus_sign:Set of calendar times to skip.
start_atdate:heavy_minus_sign:Time after which the first action may be run.
end_atdate:heavy_minus_sign:Time after which no more actions will be run.
jitterOptionalNullable[str]:heavy_minus_sign:Jitter to apply each action.

An action's scheduled time will be incremented by a random value between 0
and this value if present (but not past the next schedule).
time_zone_nameOptionalNullable[str]:heavy_minus_sign:IANA time zone name, for example US/Central.
policyOptional[models.SchedulePolicy]:heavy_minus_sign:N/A
schedule_idstr:heavy_check_mark:Unique identifier for the schedule.
remaining_executionsOptionalNullable[int]:heavy_minus_sign:Remaining workflow executions before this schedule stops triggering automatically. null means unlimited; 0 means the limit has been reached and the schedule is exhausted.
workflow_namestr:heavy_check_mark:Name of the workflow this schedule triggers.
deployment_nameOptionalNullable[str]:heavy_minus_sign:Name of the deployment this schedule targets.
pausedbool:heavy_check_mark:Whether the schedule is currently paused.
noteOptionalNullable[str]:heavy_minus_sign:Human-readable note associated with the current pause or resume state.
future_executionsList[models.ScheduleFutureExecution]:heavy_minus_sign:Upcoming scheduled executions (10 next executions, earliest first).
recent_executionsList[models.ScheduleRecentExecution]:heavy_minus_sign:Most recent scheduled executions (10 most recent, newest last).