Planned events that never arrived: remove the plan entry

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 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.

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:

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

   API keyCopy

   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.