---
title: amp events
description: "Reference for amp events list, create, get, update, and delete, for managing event taxonomy from the amp CLI."
product: general
token_estimate: 411
---
# amp events

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

`amp events` manages taxonomy: the events in a project. This command family requires the `taxonomy:read` and `taxonomy:write` scopes.

## `amp events list`

```bash
amp events list --project <project_id> --limit 5
```

In an interactive terminal, `amp events list` prints a human-friendly table. Pipe the output to a file or another command, or pass `--json`, to get raw API JSON instead.

## `amp events create`

```bash
amp events create --project <project_id> --event-type my_event --description "My event"
```

## `amp events get`

```bash
amp events get --project <project_id> --event my_event
```

## `amp events update`

Use `--project` and `--event` to identify an existing event, then pass the fields to update. Run `amp events update --help` for the full list of fields it can change, or pass `--body-json` to merge additional fields into the request:

```bash
amp events update --project <project_id> --event my_event --description "Updated description"
```

## `amp events delete`

Preview the deletion with `--dry-run`. At a terminal, the delete command asks for confirmation; pass `--yes` to skip the prompt:

```bash
amp events delete --project <project_id> --event-type my_event --dry-run   # preview
amp events delete --project <project_id> --event-type my_event --yes       # confirm
```

[Configuration](https://amplitude.com/docs/developers/cli/configuration) documents `--project`, `--json`, `--dry-run`, `--yes`, and `--body-json` in full.