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

# Delete a schedule

`DELETE /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` number, required

## Headers

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

## Response `200`

- DeleteScheduleOutput20240611
  - `status` 'success' | 'error', required

---

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