---
title: "Update a schedule"
method: PATCH
path: "/v2/schedules/{scheduleId}"
tags: ["Schedules"]
---

# Update a schedule

`PATCH /v2/schedules/{scheduleId}`

<Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.</Note>

## Path parameters

- `scheduleId` string, required

## Headers

- `Authorization` string, required
- `cal-api-version` string, required

## Request body

- UpdateScheduleInput20240611
  - `name` string
  - `timeZone` string
  - `availability` ScheduleAvailabilityInput20240611[]
    - `days` string[], required — Array of days when schedule is active.
    - `startTime` string, required — startTime must be a valid time in format HH:MM e.g. 08:00
    - `endTime` string, required — endTime must be a valid time in format HH:MM e.g. 15:00
  - `isDefault` boolean
  - `overrides` ScheduleOverrideInput20240611[]
    - `date` string, required
    - `startTime` string, required — startTime must be a valid time in format HH:MM e.g. 12:00
    - `endTime` string, required — endTime must be a valid time in format HH:MM e.g. 13:00

## Response `200`

- UpdateScheduleOutput20240611
  - `status` 'success' | 'error', required
  - `data` ScheduleOutput20240611, required
    - `id` number, required
    - `ownerId` number, required
    - `name` string, required
    - `timeZone` string, required
    - `availability` ScheduleAvailabilityInput20240611[], required
      - `days` string[], required — Array of days when schedule is active.
      - `startTime` string, required — startTime must be a valid time in format HH:MM e.g. 08:00
      - `endTime` string, required — endTime must be a valid time in format HH:MM e.g. 15:00
    - `isDefault` boolean, required
    - `overrides` ScheduleOverrideInput20240611[], required
      - `date` string, required
      - `startTime` string, required — startTime must be a valid time in format HH:MM e.g. 12:00
      - `endTime` string, required — endTime must be a valid time in format HH:MM e.g. 13:00
  - `error` object

## Changes

- **2026-07-17** (v2) `16de9d3eb7b3` — 7 breaking, 15 info
  - removed the enum value `Friday` of the request property `availability/items/days`
  - removed the enum value `Monday` of the request property `availability/items/days`
  - removed the enum value `Saturday` of the request property `availability/items/days`
  - removed the enum value `Sunday` of the request property `availability/items/days`
  - …18 more
- **2025-09-26** (v2) `daa3e48bc03a` — 5 breaking, 7 warning, 11 info
  - request property `availability/items/days` was restricted to a list of enum values
  - added the pattern `TIME_FORMAT_HH_MM` to the request property `availability/items/endTime`
  - added the pattern `TIME_FORMAT_HH_MM` to the request property `availability/items/startTime`
  - added the pattern `TIME_FORMAT_HH_MM` to the request property `overrides/items/endTime`
  - …19 more

[Change history](https://skmtc.dev/calcom/apis/cal-diy-api-v2/changes/v2/schedules/:scheduleId/patch.md)

---

[API](https://skmtc.dev/calcom/apis/cal-diy-api-v2.md) · [All operations](https://skmtc.dev/calcom/apis/cal-diy-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/calcom/cal-diy-api-v2/revisions/16de9d3eb7b3/schema)