> ## Documentation Index
> Fetch the complete documentation index at: https://docs.esperr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actions

> Manage the semantic traffic behaviors that policies evaluate.

## List all actions

```bash theme={null}
esper action list
esper action list --output json  # For scripting
```

## Create action

```bash theme={null}
esper action create \
  --name "Login Action" \
  --description "Classify login traffic." \
  --field request_path \
  --operator Eq \
  --value /login
```

This writes `~/.esper/data/actions/login-action.json` and submits the action
to Esper. Use `--local` to write the data file without submitting, or `--file`
for imports.

## Update action

```bash theme={null}
esper action update --file ./login-action-v2.json
```

<Warning>
  Action updates affect all policies referencing them. Validate changes in a non-production tenant first.
</Warning>

## Delete action

```bash theme={null}
esper action delete <action-id>
```
