---
title: "DELETE /calendarEvents/{calendarEventId}"
method: DELETE
path: "/calendarEvents/{calendarEventId}"
tags: ["Calendar Events"]
---

# DELETE /calendarEvents/{calendarEventId}

`DELETE /calendarEvents/{calendarEventId}`

Deletes a calendar event.
  - If the event to delete is recurring, **deleteAllRecurring** must be specified:
    - If **deleteAllRecurring** is true, all future occurrences of the event are deleted
    - If **deleteAllRecurring** is false, an optional **deleteOnDate** can be provided.
      - if **deleteOnDate** is provided, the event is split and the event is only deleted on the specified date and previous or future events are not deleted.
      - if the **deleteOnDate** is not provided, this is set to the event's **startTime** value.
  - If the event to delete is assigned to a group, **deleteAllGrouped** must be specified:
    - If **deleteAllGrouped** is true, all events in the group are deleted otherwise only the current event is deleted.

## Path parameters

- `calendarEventId` integer, required

## Request body

- object
  - `deleteOnDate` string, date-time, nullable
  - `deleteAllRecurring` 'TRUE' | 'FALSE', nullable
  - `deleteAllGrouped` 'TRUE' | 'FALSE', nullable

## Response `204`

Calendar event deleted successfully

## Other responses

- `4XX` — Client Request Errors
- `5XX` — Server Errors

---

[API](https://skmtc.dev/fergus/apis/fergus-api.md) · [All operations](https://skmtc.dev/fergus/apis/fergus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fergus/fergus-api/revisions/b4f232a22363/schema)