Delete External Event
Description #
Deletes an externally managed event from a user’s calendar.
In order to make this call, you must request elevated access to access the user’s calendars.
Then, the event itself must be have its options.delete
flag set to true
.
URL format #
api.cronofy.com/v1/calendars/{calendar_id}/events
Example Request #
DELETE /v1/calendars/cal_n23kjnwrw2_jsdfjksn234/events HTTP/1.1
Host: api.cronofy.com
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json; charset=utf-8
{
"event_uid": "evt_external_54008b1a4a41730f8d5c6037"
}
Example Response #
HTTP/1.1 202 Accepted
Request parameters #
calendar_id required #
The calendar_id
of the calendar you wish the event to be removed from. This ID should have been discovered by making a list calendars request and must not have a calendar_readonly
value that is true
.
event_uid required #
The String
that uniquely identifies the event. The combination of calendar_id
and event_uid
combination will be used to delete the event.
This will be an ID retrieved as part of a read events request.
Notification channels
You will not receive a push notification after the update you have requested has been applied. Much like for fully managed events we eliminate these notifications as it is wasteful for everyone to be informed about the request you just made.
Caveats #
Recurring events
Recurring events are not editable. In order to know if an event can be deleted or updated the options attribute can be inspected when making a Read Events request.
Recurring events can also be identified by the recurring
Boolean attribute on events when making a Read Events request.