Skip to main content
Manage notification policies from the command line. Define match rules and connect policies to alert channels via escalation chains.

​
Commands

CommandDescription
devhelm notification-policies listList all policies
devhelm notification-policies get <id>Get policy details
devhelm notification-policies createCreate a policy
devhelm notification-policies update <id>Update a policy
devhelm notification-policies delete <id>Delete a policy
devhelm notification-policies test <id>Test a policy

​
notification-policies list

devhelm notification-policies list
FlagTypeDefaultDescription
--page-sizeinteger200Number of items per API request (1–200)

​
notification-policies get

Policy and channel IDs are UUIDs — get them from the matching list commands. 
devhelm notification-policies get <policy-id> -o json

​
notification-policies create

Create a new notification policy with associated alert channels. 
devhelm notification-policies create \
  --name "Production Alerts" \
  --channel-ids <channel-id-1>,<channel-id-2> \
  --enabled
FlagTypeRequiredDescription
--namestringYesPolicy display name
--channel-idsstring—Comma-separated alert channel IDs (UUIDs) for the escalation step
--enabled / --no-enabledboolean—Whether the policy is active (default: true)
The CLI creates the policy with a single escalation step (zero delay, the given channels) and no match rules, so it matches every incident. Multi-step escalation chains, delays, and match rules aren’t expressible through these flags — define the policy in devhelm.yml (see escalation chains) and run devhelm deploy.

​
notification-policies update

devhelm notification-policies update <policy-id> \
  --name "Production Alerts (critical)" \
  --channel-ids <channel-id-1>,<channel-id-2>
Supports the same flags as create. Passing --channel-ids replaces the escalation with a single zero-delay step containing those channels.

​
notification-policies delete

Prompts for confirmation; pass --yes (-y) in scripts and CI. 
devhelm notification-policies delete <policy-id>

​
notification-policies test

Send a test notification through the policy to verify it triggers correctly. 
devhelm notification-policies test <policy-id>

​
Next steps

Notification policies

Understanding match rules and escalation logic.

Escalation chains

Multi-step escalation with delays and conditions.