---
title: "Remove an event"
description: "Takes an event off the calendar for good, as Remove does in the app. Nobody else is told."
url: "https://openemail.uk/docs/api/calendar/delete"
area: "API"
category: "Mailbox"
---

# Remove an event

Takes an event off the calendar for good, as Remove does in the app. Nobody else is told.

`DELETE /calendar/events/{id}`

## DELETE /calendar/events/{id}

Takes an event off the calendar for good, as Remove does in the app. Nobody else is told.

## Example

Needs `calendar:write`.

**curl**

```
curl -X DELETE "$OE/calendar/events/cal_3f9a1c7e5b2d48a06c1e9f4b" -H "$AUTH"
```

**Response**

```
{
  "object": "calendar_event",
  "id": "cal_3f9a1c7e5b2d48a06c1e9f4b",
  "deleted": true
}
```

> An event organised by somebody else is a 403 `not_organizer`.

## Reference

- [`DELETE /calendar/events/{id}`](https://openemail.uk/docs/api/reference/calendar#delete-calendar-events-id): full reference