Skip to main content
PUT
Update a resource group's name, description, alert policy, inherited settings, and health threshold

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required

Body

application/json

Request body for updating a resource group

name
string
required

Human-readable name for this group

Maximum string length: 255
description
string | null

Optional description (max 500); null clears the existing value

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

Optional notification policy to apply for this group; null clears the existing value

defaultFrequency
integer<int32> | null

Default check frequency in seconds for members (30–86400); null clears

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

Default regions for member monitors; null clears

Default regions for member monitors; null clears

defaultRetryStrategy
object | null

Default retry strategy for member monitors; null clears

defaultAlertChannels
string<uuid>[] | null

Default alert channel IDs for member monitors; null clears

Default alert channel IDs for member monitors; null clears

defaultEnvironmentId
string<uuid> | null

Default environment ID for member monitors; null clears

healthThresholdType
enum<string> | null

Health threshold type: COUNT or PERCENTAGE; null disables threshold

Available options:
COUNT,
PERCENTAGE
healthThresholdValue
number | null

Health threshold value; null disables threshold

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

Suppress member-level alert notifications; null preserves current value

confirmationDelaySeconds
integer<int32> | null

Confirmation delay in seconds; null clears

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

Recovery cooldown in minutes; null clears

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

New attribution source: DASHBOARD, CLI, TERRAFORM, MCP, or API; null preserves current value.

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

Response

OK

data
object
required

Resource group with health summary and optional member details