Skip to main content
View and manage incidents from the command line. List active incidents, inspect details, create manual incidents, and resolve them.

​
Commands

CommandDescription
devhelm incidents listList incidents
devhelm incidents get <id>Get incident details
devhelm incidents createCreate a manual incident
devhelm incidents resolve <id>Resolve an incident

​
incidents list

List all incidents in your organization. 
devhelm incidents list
FlagTypeDefaultDescription
--page-sizeinteger200Number of items per API request (1–200)
Filter by status using jq: 
devhelm incidents list -o json | jq '[.[] | select(.status == "ACTIVE")]'

​
incidents get

Get detailed information about a single incident, including its timeline. 
devhelm incidents get 42

devhelm incidents get 42 -o json

​
incidents create

Create a manual incident. Manual incidents are useful for tracking outages detected outside of automated monitoring. 
devhelm incidents create \
  --title "Payment API degraded" \
  --severity DEGRADED
FlagTypeRequiredDescription
--titlestringYesShort summary of the incident
--severitystringYesSeverity: DOWN, DEGRADED, MAINTENANCE
--monitor-idstring—Associate with a specific monitor
--bodystring—Detailed description of the incident

​
Examples

devhelm incidents create \
  --title "Scheduled database migration" \
  --severity MAINTENANCE \
  --body "Migrating to new schema, expected 10min downtime"

devhelm incidents create \
  --title "CDN provider outage" \
  --severity DOWN \
  --monitor-id 42

​
incidents resolve

Resolve an active incident. 
devhelm incidents resolve 42
Add a resolution message: 
devhelm incidents resolve 42 --message "Root cause identified and patched"
FlagTypeDescription
--messagestringResolution message added to the incident timeline

​
Next steps

Incidents overview

Understanding incident lifecycle and policies.

Manual incidents guide

Step-by-step guide for managing manual incidents.