Skip to main content
POST
Create a maintenance window

Authorizations

Authorization
string
header
required

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

Body

application/json
startsAt
string<date-time>
required

Scheduled start of the maintenance window (ISO 8601)

endsAt
string<date-time>
required

Scheduled end of the maintenance window (ISO 8601)

monitorId
string<uuid> | null

Monitor to attach this maintenance window to; null for org-wide

repeatRule
string | null

Reserved: iCal RRULE for recurring windows (stored but not yet honored)

Maximum string length: 100
reason
string | null

Human-readable reason for the maintenance (max 500 chars)

Maximum string length: 500
suppressAlerts
boolean | null

Whether to suppress alerts during this window (default: true)

Response

Created

data
object
required

Scheduled maintenance window for a monitor