Skip to main content
POST
Create a notification policy with match rules and escalation chain

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Headers

Idempotency-Key
string

Replays the stored response for 24h when the same key is sent again (1–255 visible ASCII)

X-DevHelm-Client
string

Calling surface and version, e.g. cli/1.4.0 or sdk-js/2.0.0

Body

application/json

Request body for creating a notification policy

name
string
required

Human-readable name for this policy

Maximum string length: 255
escalation
object
required

Escalation chain defining which channels to notify; null preserves current

description
string | null

Optional note; omit or null when unused

Maximum string length: 500
matchRules
object[] | null

Match rules to evaluate (all must pass; omit or empty for catch-all)

enabled
boolean | null
default:true

Whether this policy is enabled (default true)

priority
integer<int32> | null
default:0

Evaluation priority; higher value = evaluated first (default 0)

Response

Created

data
object
required

Org-level notification policy with match rules and escalation chain