---
title: "Planned events that never arrived: remove the plan entry"
description: "Remove an approved, unseen event from the tracking plan in Amplitude Data or with the Taxonomy API."
product: data
token_estimate: 707
---
# Planned events that never arrived: remove the plan entry

> For AI agents: a documentation index is available at [/docs/llms.txt](/docs/llms.txt). Append `.md` to any page URL for markdown, or send `Accept: text/markdown`.

Remove an approved planned event from the tracking plan in Amplitude Data. Use the Taxonomy API instead when you need an automated workflow. Data Assistant has no direct action for this task.

## Prerequisites

Before you remove a planned event, you need:

- The exact event name.
- Permission to manage the tracking plan.
- Written confirmation from the event owner.
- A completed [planned unseen events audit](https://amplitude.com/docs/data/data-assistant-user-solutions/planned-unseen-events-audit) that confirms the event has never produced data.

Do not use this workflow for an event that has produced data. Deleting a live event has different behavior from removing a planned event.

## Remove the planned event in Amplitude Data

1. Go to the _Events_ section in Amplitude Data.
2. Select the approved planned event.
3. Select **Delete** and complete the verification dialog.
4. Confirm the entry no longer appears in the tracking plan.

Deleting a planned event removes its entry from the tracking plan. The deletion doesn't remove historical data. Use this procedure only after the audit confirms that the event has no historical data. For general UI behavior, refer to [Delete events and properties in Amplitude Data](https://amplitude.com/docs/data/remove-invalid-data#delete-events-and-properties-in-amplitude-data).

## Use the Taxonomy API for automation

The Taxonomy API is an Enterprise feature. You need a project API key and secret key. Use the base URL for the project's data residency:

| Data residency | Base URL |
| --- | --- |
| Default | `https://amplitude.com` |
| EU | `https://analytics.eu.amplitude.com` |

1. Store the project API key and secret key in your approved secret-management workflow. Don't paste credentials into tickets or shared documents.
2. URL-encode the exact event name for the request path.
3. Send a `DELETE` request to the Taxonomy API. This example uses the default-residency host:

   ```bash
   curl --request DELETE \
     --user "$AMPLITUDE_API_KEY:$AMPLITUDE_SECRET_KEY" \
     "https://amplitude.com/api/2/taxonomy/event/URL_ENCODED_EVENT_NAME"
   ```
4. Confirm the API returns `200 OK` with `"success": true`.
5. Refresh _Data > Events_ and confirm the planned entry no longer appears in the tracking plan.

> **Warning:** Verify the event state
>
> For a planned event, the endpoint removes the event from the tracking plan. For a live event, the endpoint marks the event as deleted. Refer to [Delete an event type](https://amplitude.com/docs/apis/analytics/taxonomy#delete-an-event-type) for state-specific behavior and error responses.