Skip to main content
POST
Create a new resource group

Authorizations

Authorization
string
header
required

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

Body

application/json

Request body for creating a resource group

name
string
required

Human-readable name for this group

Maximum string length: 255
description
string | null

Optional description (max 500)

Maximum string length: 500
alertPolicyId
string<uuid> | null

Optional notification policy to apply for this group

defaultFrequency
integer<int32> | null

Default check frequency in seconds applied to members (30–86400)

Required range: 30 <= x <= 86400
defaultRegions
string[] | null

Default regions applied to member monitors

Default regions applied to member monitors

defaultRetryStrategy
object | null

Default retry strategy for member monitors; null clears

defaultAlertChannels
string<uuid>[] | null

Default alert channel IDs applied to member monitors

Default alert channel IDs applied to member monitors

defaultEnvironmentId
string<uuid> | null

Default environment ID applied to member monitors

healthThresholdType
enum<string> | null

Health threshold type: COUNT or PERCENTAGE

Available options:
COUNT,
PERCENTAGE
healthThresholdValue
number | null

Health threshold value: count (0+) or percentage (0–100)

Required range: 0 < x < 100
suppressMemberAlerts
boolean | null

Suppress member-level alert notifications when group manages alerting

confirmationDelaySeconds
integer<int32> | null

Confirmation delay in seconds before group incident creation (0–600)

Required range: 0 <= x <= 600
recoveryCooldownMinutes
integer<int32> | null

Recovery cooldown in minutes after group incident resolves (0–60)

Required range: 0 <= x <= 60
managedBy
enum<string> | null

Source creating this group: DASHBOARD, CLI, TERRAFORM, MCP, or API. Defaults to API when omitted.

Available options:
DASHBOARD,
CLI,
TERRAFORM,
MCP,
API

Response

Created

data
object
required

Resource group with health summary and optional member details