Bulk Delete Events

Required plan: Starter

Description #

Delete events that you are managing from the user’s calendars in bulk.

URL format #

api.cronofy.com/v1/events

Example Requests #

Delete all events from all calendars
DELETE /v1/events HTTP/1.1
Host: api.cronofy.com
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json; charset=utf-8

{
  "delete_all": true
}
Delete all events from specific calendars
DELETE /v1/events HTTP/1.1
Host: api.cronofy.com
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json; charset=utf-8

{
  "calendar_ids" : [ "cal_n23kjnwrw2_sakdnawerd3" ]
}

Example Response #

HTTP/1.1 202 Accepted

Request parameters #

delete_all optional  #

A Boolean specifying whether all events you are managing for the user should be deleted. When specified must be true.

calendar_ids optional  #

An Array specifying the calendars from which to delete all events you are managing for the user. When provided at least one calendar must be specified.

Response Errors #

Only one of delete_all or calendar_ids must be provided in the body, if both are set this is considered an error.