---
title: "Update Schedule"
method: PATCH
path: "/v1/workflows/schedules/{schedule_id}"
tags: ["workflows.schedules"]
---

# Update Schedule

`PATCH /v1/workflows/schedules/{schedule_id}`

Update Schedule

## Path parameters

- `schedule_id` string, required

## Request body

- WorkflowScheduleUpdateRequest
  - `schedule` PartialScheduleDefinition, required — Schedule definition for partial updates. All fields are optional (inherited from _ScheduleRequestBase). Only explicitly-set fields are applied during an update; unset fields preserve the existing schedule values.
    - `input` unknown
    - `calendars` ScheduleCalendar[] — Calendar-based specification of times.
      - `second` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `minute` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `hour` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `day_of_month` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `month` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `year` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `day_of_week` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `comment` string, nullable
    - `intervals` ScheduleInterval[] — Interval-based specification of times.
      - `every` string, duration, required
      - `offset` string, duration, nullable
    - `cron_expressions` string[] — Cron-based specification of times.
    - `skip` ScheduleCalendar[] — Set of calendar times to skip.
      - `second` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `minute` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `hour` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `day_of_month` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `month` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `year` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `day_of_week` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `comment` string, nullable
    - `start_at` string, date-time, nullable — Time after which the first action may be run.
    - `end_at` string, date-time, nullable — Time after which no more actions will be run.
    - `jitter` string, duration, nullable — 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_name` string, nullable — IANA time zone name, for example ``US/Central``.
    - `policy` SchedulePolicy
      - `catchup_window_seconds` integer — After a Temporal server is unavailable, amount of time in seconds in the past to execute missed actions.
      - `overlap` 1 | 2 | 3 | 4 | 5 | 6 — Controls what happens when a workflow would be started by a schedule but one is already running.
      - `pause_on_failure` boolean — Whether to pause the schedule after a workflow failure.
    - `max_executions` integer, nullable — Maximum number of times this schedule will trigger a workflow execution. Once this limit is reached, no further executions are triggered automatically. null means unlimited.

## Response `200`

Successful Response

- WorkflowScheduleResponse
  - `schedule_id` string, required — The ID of the schedule

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)