---
title: "Delete event"
method: DELETE
path: "/sites/{site_id}/events"
tags: ["Events"]
---

# Delete event

`DELETE /sites/{site_id}/events`

Delete an event by its name. If more than one event row shares the name, they are treated as one event and every matching row is deleted.

**Permissions:** Requires write access to the site (`manage:{site_id}`).

**Returns:** Returns a deleted object on success. Otherwise, this call returns an error.

## Path parameters

- `site_id` string, required

## Query parameters

- `name` string, required

## Response `200`

Successful response

## Other responses

- `400` — Bad request. Returned for validation failures and other request problems. Send `Accept: application/json` to receive errors as JSON.
- `401` — Authentication failed — the API token is missing, malformed or invalid.

## Changes

- **2026-08-24** `93547ee49398` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usefathom/apis/fathom-analytics-api/changes/sites/:site_id/events/delete.md)

---

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