---
title: "Delete a project event definition and its events"
method: DELETE
path: "/event-definitions/{id}"
tags: ["Events"]
---

# Delete a project event definition and its events

`DELETE /event-definitions/{id}`

Permanently deletes the event definition and all recorded event emissions
associated with it. This action cannot be undone. The endpoint returns
`202 Accepted` while a background job performs the deletion; new events
with the same name are rejected while deletion is pending. To retain
historical events while hiding the definition from new tools and workflow
selectors, archive it with the PATCH endpoint instead.

## Path parameters

- `id` string, uuid, required

## Response `202`

Deletion queued for the definition and associated event emissions

## Other responses

- `401` — Missing or invalid API key
- `404` — Resource not found

---

[API](https://skmtc.net/kapso/apis/kapso-platform-api.md) · [All operations](https://skmtc.net/kapso/apis/kapso-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kapso/kapso-platform-api/revisions/18ff5548a33f/schema)