Skip to main content
PUT
Update a maintenance window

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required
windowId
string<uuid>
required

Body

application/json
title
string | null

New title; null preserves current

Maximum string length: 500
status
enum<string> | null

New status; null preserves current

Available options:
INVESTIGATING,
IDENTIFIED,
MONITORING,
RESOLVED
impact
enum<string> | null

New impact level; null preserves current

Available options:
NONE,
MINOR,
MAJOR,
CRITICAL
affectedComponents
object[] | null

Updated affected components; null preserves current

postmortemBody
string | null

Postmortem body in markdown; empty string clears

postmortemUrl
string | null

URL to an external postmortem document; empty string clears

Maximum string length: 2048
Pattern: ^$|^https?://.*
published
boolean | null

Whether the incident is published on the public page; null preserves current. true publishes (sets publishedAt); false unpublishes (clears publishedAt)

scheduledFor
string<date-time> | null

New maintenance window start; null preserves current. Only for scheduled incidents

scheduledUntil
string<date-time> | null

New maintenance window end; null preserves current. Only for scheduled incidents

autoResolve
boolean | null

Whether the window auto-completes at scheduledUntil; null preserves current

Response

OK

data
object
required