Create a maintenance window that suppresses alerts for matching monitors.
POST
/maintenance_windows
const url = 'https://api.siteqwality.com/maintenance_windows';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name":"example","tags":["example"],"service_ids":["2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"],"schedule_type":"example","timezone":"example","starts_at":"2026-04-15T12:00:00Z","ends_at":"2026-04-15T12:00:00Z","recurrence":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.siteqwality.com/maintenance_windows \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "example", "tags": [ "example" ], "service_ids": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "schedule_type": "example", "timezone": "example", "starts_at": "2026-04-15T12:00:00Z", "ends_at": "2026-04-15T12:00:00Z", "recurrence": "example" }'Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ” Media type application/json
object
name
required
string
tags
Monitors with any of these tags are held. May be empty when service_ids is not.
Array<string>
service_ids
Every monitor and alert rule of these services is held, and their auto incidents wait.
Array<string>
schedule_type
required
string
timezone
string | null
starts_at
string | null format: date-time
ends_at
string | null format: date-time
recurrence
Example generated
{ "name": "example", "tags": [ "example" ], "service_ids": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "schedule_type": "example", "timezone": "example", "starts_at": "2026-04-15T12:00:00Z", "ends_at": "2026-04-15T12:00:00Z", "recurrence": "example"}Responses
Section titled “ Responses ”Maintenance window created
Media type application/json
object
id
required
string format: uuid
account_id
required
string format: uuid
name
required
string
tags
required
Array<string>
service_ids
The services the window covers.
Array<string>
schedule_type
required
string
timezone
required
string
starts_at
string | null format: date-time
ends_at
string | null format: date-time
recurrence
is_currently_active
required
boolean
created_at
required
string format: date-time
updated_at
required
string format: date-time
Example generated
{ "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "account_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "name": "example", "tags": [ "example" ], "service_ids": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "schedule_type": "example", "timezone": "example", "starts_at": "2026-04-15T12:00:00Z", "ends_at": "2026-04-15T12:00:00Z", "recurrence": "example", "is_currently_active": true, "created_at": "2026-04-15T12:00:00Z", "updated_at": "2026-04-15T12:00:00Z"}Invalid request body, or neither tags nor services
Missing or invalid authentication
A service in service_ids is not in this account
Internal server error