Policies

List policies

esper policy list
esper policy list --status active  # Filter by status

Create policy

esper policy create \
  --name "Login Policy" \
  --description "Evaluate login traffic by actor." \
  --field request_path \
  --operator Eq \
  --value /login \
  --action login-action \
  --entity login-actor

This creates a single-clause policy, writes ~/.esper/data/policies/login-policy.json, and submits it to Esper. --action, --entity, and --mitigation accept UUIDs or local data names. Use --file for multi-clause or advanced policy payloads.

Apply policy (idempotent)

esper policy apply --file ./policy.json

The apply command creates or updates based on policy_id presence in the JSON:

With policy_id: Updates existing policy
Without policy_id: Creates new policy

Best PracticeUse apply in CI/CD pipelines for declarative policy management.

Update policy

esper policy update --file ./policy-update.json

Delete policy

esper policy delete <policy-id>

Common Workflows

Deploy new policy set

# 1. Validate current state
esper policy list

# 2. Apply policies declaratively
esper policy apply --file policies/rate-limiting.json
esper policy apply --file policies/authentication.json

# 3. Verify deployment
esper results policies

Rollback policy change

# 1. Export current policy
esper policy show <policy-id> --output json > policy-backup.json

# 2. Make changes
esper policy update --file policy-new.json

# 3. If issues, restore
esper policy apply --file policy-backup.json

Settings

Services

Integrations

CLI

Policies

List policies

Create policy

Apply policy (idempotent)

Update policy

Delete policy

Common Workflows

Deploy new policy set

Rollback policy change

​List policies

​Create policy

​Apply policy (idempotent)

​Update policy

​Delete policy

​Common Workflows

​Deploy new policy set

​Rollback policy change

List policies

Create policy

Apply policy (idempotent)

Update policy

Delete policy

Common Workflows

Deploy new policy set

Rollback policy change