privy policies delete

Delete an unused, unowned policy; requires exact current name confirmation.

Usage

privy policies delete [options] <policy-id>

Arguments

Argument	Description
policy-id	—

Options

Option	Description
--dry-run	Validate and print the API request without network access or credentials.
--yes	Confirm this mutation or export.
--confirm-name <name>	Exact resource name, checked against a fresh preflight read.
--allow-production	Explicitly allow this production mutation; also requires --yes.

Global options such as --app, --account and --profile also apply. See the command reference overview.

Examples

privy policies delete <policy-id> --confirm-name payout-guard --dry-run
privy policies delete <policy-id> --confirm-name payout-guard --yes

Behavior

• Changes data: yes. Preview with --dry-run, then run with --yes and any required confirmations.
• Scope: app
• Before it runs: Read app environment; existing policies must have owner_id: null. Policy deletion also requires exact name and deletable: true.
• Production apps: Requires --allow-production in addition to --yes.
• Verification: Fresh policy read and field comparison; deletion requires verified absence.
• Retries: None.

Related guides

• Policies and approvals
• Failure recovery

Inspect the full contract locally with privy schema policies delete.