Start maintenance
POST /api/v1/monitors/{id}/maintenance
POST
/api/v1/monitors/{id}/maintenance
Start a maintenance window for the specified duration. Checks continue but incident creation is suppressed.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string
Request Body required
Section titled “Request Body required ”object
maintenanceUntil
required
ISO 8601 end datetime for maintenance (max 7 days ahead)
string format: date-time
notify
Send notification to configured channels (requires notifications module)
boolean
autoResolve
When true, maintenance auto-resolves at the scheduled end time. When false, maintenance persists until manually ended.
boolean
Responses
Section titled “ Responses ”Maintenance started
object
monitor
object
id
string
teamId
string
type
string
name
string
config
Type-specific configuration
object
intervalSeconds
integer
status
string
isActive
integer
lastCheckedAt
string format: date-time
maintenanceUntil
ISO 8601 timestamp until which the monitor is under maintenance. Null when not in maintenance.
string format: date-time
autoResolveMaintenance
Whether maintenance auto-resolves (1) or requires manual resolution (0).
integer
createdAt
string format: date-time
updatedAt
string format: date-time
Validation error
Monitor not found