Skip to main content
Manage alert channels from the command line. Create channels, update configs, and send test notifications.

Commands

CommandDescription
devhelm alert-channels listList all alert channels
devhelm alert-channels get <id>Get channel details
devhelm alert-channels createCreate an alert channel
devhelm alert-channels update <id>Update a channel
devhelm alert-channels delete <id>Delete a channel
devhelm alert-channels test <id>Send a test notification

alert-channels list

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

alert-channels get

devhelm alert-channels get 42 -o json

alert-channels create

Create a new alert channel.
devhelm alert-channels create \
  --name "Slack Alerts" \
  --type SLACK \
  --webhook-url https://hooks.slack.com/services/T00/B00/xxx
FlagTypeRequiredDescription
--namestringYesChannel display name
--typestringYesChannel type: SLACK, EMAIL, PAGERDUTY, OPSGENIE, DISCORD, TEAMS, WEBHOOK
--webhook-urlstringWebhook URL for Slack, Discord, or Teams channels
--configstringChannel-specific configuration as JSON

Examples by type

devhelm alert-channels create \
  --name "Slack Alerts" \
  --type SLACK \
  --webhook-url https://hooks.slack.com/services/T00/B00/xxx
For channels that need more than a webhook URL (PagerDuty, OpsGenie, Email, Webhook), pass configuration as a JSON string with --config.

alert-channels update

devhelm alert-channels update 42 \
  --name "Slack Alerts (prod)" \
  --webhook-url https://hooks.slack.com/services/T00/B00/new
Supports the same flags as create.

alert-channels delete

devhelm alert-channels delete 42
Deleting a channel removes it from all notification policies that reference it. Verify the channel isn’t in use before deleting.

alert-channels test

Send a test notification through the channel to verify the configuration.
devhelm alert-channels test 42

Next steps

Alert channels reference

Detailed configuration for each channel type.

Integrations

Setup guides for Slack, PagerDuty, OpsGenie, and more.