---
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

---

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