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.

Parameters

uid
string
required
The event’s iCalendar UID, from create_calendar_event or list_calendar_events.
calendarUrl
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
{ "uid": "9b1de2a4-6f0e-4c8b-a1d2-3e4f5a6b7c8d@langmail.me" }
Result
Event 9b1de2a4-6f0e-4c8b-a1d2-3e4f5a6b7c8d@langmail.me deleted; Stalwart will send cancellations to any attendees.

Errors

  • Event not found: <uid> — no event with that UID in the target calendar.
  • 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.