Schedule recurring maintenance

A recurring window repeats daily, or weekly on chosen days, instead of running once. Recurrences have no end date, so for something that happens only a few times (such as a quarterly DB rotation), create one-time windows instead.

In the dashboard

Go to Respond → Notifications, click Maintenance windows, then + Add maintenance window.
Give it a Name, then the Tags or Services (or both) whose monitors it should silence.
Set Schedule type to Recurring and pick the Time zone.
Under Recurrence pattern, choose Daily, or Weekly (specific days) and tick the Days. Set the Start time and End time.
Click Create window.

To change or remove a window later, use Edit window or Delete window on its row.

Daily: same window every day

Through the API, with an API key exported as SITEQWALITY_API_KEY:

curl -X POST https://api.siteqwality.com/maintenance_windows \
  -H "Authorization: Bearer $SITEQWALITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Nightly batch ETL",
    "tags": ["service:etl"],
    "schedule_type": "recurring",
    "timezone": "America/Los_Angeles",
    "recurrence": {
      "type": "daily",
      "start_time": "02:00",
      "end_time": "03:00"
    }
  }'

start_time and end_time are 24-hour HH:MM strings interpreted in the window’s timezone. If end_time is earlier than start_time, the window crosses midnight: start_time: "23:00", end_time: "01:00" runs from 11pm to 1am. One window covers it.

Weekly: chosen days each week

curl -X POST https://api.siteqwality.com/maintenance_windows \
  -H "Authorization: Bearer $SITEQWALITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sunday maintenance",
    "tags": ["env:prod"],
    "schedule_type": "recurring",
    "timezone": "UTC",
    "recurrence": {
      "type": "weekly",
      "days": ["sunday"],
      "start_time": "02:00",
      "end_time": "04:00"
    }
  }'

days is an array of day names, matched case-insensitively. Full English names (monday .. sunday) and three-letter abbreviations (mon .. sun) both work; anything else is rejected at creation. List several to cover each, such as "days": ["saturday", "sunday"] for both weekend days.

Timezones

Set timezone explicitly. It defaults to UTC, so “02:00” means 02:00 UTC unless you choose your team’s zone. Values are IANA timezone names: America/Los_Angeles, America/New_York, Europe/London, Asia/Tokyo, etc.

Updating a recurring window

Sending a PUT to the window’s id (from GET /maintenance_windows) with a partial body updates only those fields:

curl -X PUT https://api.siteqwality.com/maintenance_windows/$WINDOW_ID \
  -H "Authorization: Bearer $SITEQWALITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recurrence": {
      "type": "weekly",
      "days": ["saturday", "sunday"],
      "start_time": "01:00",
      "end_time": "05:00"
    }
  }'

Disabling vs deleting

Windows have no disabled flag. To stop a window from firing, delete it with Delete window in the dashboard or through the API:

curl -X DELETE https://api.siteqwality.com/maintenance_windows/$WINDOW_ID \
  -H "Authorization: Bearer $SITEQWALITY_API_KEY"