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)
Incident status is one of WATCHING, TRIGGERED, CONFIRMED, or RESOLVED. Filter with jq — for example, everything that isn’t resolved yet: 
devhelm incidents list -o json | jq '[.[] | select(.status != "RESOLVED")]'

​
incidents get

Get detailed information about a single incident, including its timeline. Incident IDs are UUIDs — get them from devhelm incidents list. 
devhelm incidents get <incident-id>

devhelm incidents get <incident-id> -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 (UUID)
--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 <monitor-id>

​
incidents resolve

Resolve an active incident. 
devhelm incidents resolve <incident-id>
Add a resolution message: 
devhelm incidents resolve <incident-id> --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.