Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.devhelm.io/llms.txt

Use this file to discover all available pages before exploring further.

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 (lowercase): email, slack, discord, webhook, pagerduty, opsgenie, teams
--webhook-urlstring—Webhook URL for Slack, Discord, or Teams channels
--configstring—Channel-specific configuration as JSON
CLI --type values are lowercase, matching the OpenAPI enum the CLI is generated from. The YAML file format historically accepts uppercase aliases — when copy-pasting between the two, normalize to lowercase for the CLI flag.

​
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.