> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Erase a Signal Definition

> Permanently erase a custom signal definition from your account.

No longer using a custom event and want to retire it?

Call this endpoint using the event's ID badge or name. Mailofly will erase its definition cleanly from your catalog!

### Path Parameters

**id** `string` *required*

The ID badge or the name of the event (e.g. `"evt_4b219081..."` or `"old.event"`).

### Response

**object** `string`

Always says `"event"`.

**id** `string`

The ID badge of the erased event.

**deleted** `boolean`

`true` confirming the signal definition is gone.

```bash cURL theme={null}
curl -X DELETE 'https://api.mailofly.com/events/old.event' \
  -H 'Authorization: Bearer mf_live_xxxxxxxx'
```

```javascript Node.js theme={null}
import { Mailofly } from "@mailofly/node";

const mailofly = new Mailofly("mf_live_xxxxxxxx");

const result = await mailofly.events.delete("old.event");

console.log("Erased signal definition? Status:", result.deleted);
```

```json 200 OK theme={null}
{
  "object": "event",
  "id": "evt_4b219081-3a11-4821-b810-091827361821",
  "deleted": true
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.