Delete a schedule

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.

If accessed using an OAuth access token, the SCHEDULE_WRITE scope is required.

DELETE /v2/schedules/{scheduleId}

Delete a schedule

cURL

curl --request DELETE \
  --url https://api.cal.com/v2/schedules/{scheduleId} \
  --header 'Authorization: <authorization>' \
  --header 'cal-api-version: <cal-api-version>'

200

{
  "status": "success"
}

Headers

Authorization · string · required

value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token

cal-api-version · string · default: 2024-06-11 · required

Must be set to 2024-06-11. If not set to this value, the endpoint will default to an older version.

Path Parameters

scheduleId · number · required

Response

200 - application/json

status · enum<string> · required

Available options: success, error

Example:

"success"