--- title: "amp event-properties" description: "Reference for listing, creating, reading, updating, and deleting event properties with the amp CLI." product: general token_estimate: 512 --- # amp event-properties > 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 event-properties` manages properties associated with an event. Read commands require `taxonomy:read`; create, update, and delete require `taxonomy:write`. ## `amp event-properties list` ```bash amp event-properties list --project --event --limit 5 ``` The result includes ingested-only properties that aren't in the tracking plan. Check `is_in_schema` before updating a property. ## `amp event-properties create` ```bash amp event-properties create --project --event \ --property --data-type string ``` Creating an ingested-only property promotes it into the tracking plan. If the property already exists in the plan, the command returns it without changing it. ## `amp event-properties get` ```bash amp event-properties get --project --event \ --property ``` ## `amp event-properties update` ```bash amp event-properties update --project --event \ --property --description "Updated description" ``` You can update properties in the tracking plan. Updating an ingested-only property returns `422` with `error_code: "not_in_schema"`; create it first to promote it. For array fields such as `enum_values` and `classifications`, an update replaces the entire array. ## `amp event-properties delete` ```bash amp event-properties delete --project --event \ --property --dry-run amp event-properties delete --project --event \ --property --yes ``` Preview the deletion with `--dry-run`. At a terminal, the delete command asks for confirmation; pass `--yes` to skip the prompt. Run `amp event-properties --help` for pagination, search, property metadata, and other command-specific flags.