Skip to main content
Deletes an event. The mail server sends standard iMIP cancellations to any attendees, so the event disappears from their calendars too. By default this deletes the entire event — for a recurring event, every occurrence. To cancel just one occurrence of a recurring series, pass recurrenceId (see below); the master rule and every other occurrence stay untouched, and attendees are notified so only that instance is removed from their calendars.

​
Parameters

​
string
required
The event’s iCalendar UID, from create_calendar_event or list_calendar_events.
​
string
An ISO 8601 instant (with offset, e.g. 2026-06-16T10:00:00Z) that scopes the deletion to a single occurrence of a recurring series, identified by that occurrence’s original start. When set, only that one occurrence is cancelled; omit it to delete the whole event. The instant must land on an actual occurrence of the series.
​
string
A CalDAV URL from list_calendars. Defaults to the user’s default calendar — pass this if the event lives in another calendar.

​
Example

Call
Result

​
Cancel one occurrence

Call
Result

​
Errors

  • Event not found: <uid> — no event with that UID in the target calendar.
  • Event <uid> is not a recurring series; omit recurrenceId to delete it. — recurrenceId was given for a one-off event.
  • recurrenceId <instant> does not match an occurrence of this series (<rrule>); it must equal an occurrence's original start. — the instant doesn’t fall on the series.
  • Could not evaluate this series' recurrence rule (<rrule>) to validate recurrenceId <instant>. — the stored series has a recurrence rule that can’t be parsed, so the occurrence can’t be verified.
  • No calendar available to delete the event from. — the user has no calendar and none was specified.
  • Calendar not found: <url> — the calendarUrl didn’t resolve.