Schedule a maintenance window
During a window, covered monitors keep running; alerts, new incidents and reminders for alert-opened incidents are muted, failures do not count toward the alert threshold, and uptime leaves the checks out. Needs monitor update permission (and status page update to publish). 30 changes per minute per user.
bearerAuthAuthorizationBearer <token>Project-scoped CLI token (sck_live_* or sck_test_*) for documented API operations that accept bearer authentication. Interactive browser operations may require a session cookie. Trigger keys (sck_trigger_* / legacy job_*) are accepted only by job trigger endpoints.
application/json- body
title*stringlength <= 200description?stringlength <= 2000scope*string"project""services""monitors"targets?recurrence*string"once""daily""weekly""monthly"timezone*stringIANA time zone
localStartTime*string^\d{2}:\d{2}$durationMinutes*integerShorter than the time between occurrences
5 <= value <= 10080startsOn*stringdateendsOn?stringdateweekdays?array<>Weekly: 0 = Sunday
monthDay?integerMonthly: 1-28, or -1 for the last day
statusPages?array<>One-off windows only
notifySubscribers?booleanfalseScheduled; warning status_page_failed if only the status page post failed
application/json- response
success?booleanwindow?curl -X POST 'https://app.supercheck.io/api/maintenance-windows' \ -H 'Content-Type: application/json' \ -d '{ "title": "string", "scope": "project", "recurrence": "once", "timezone": "string", "localStartTime": "string", "durationMinutes": 5, "startsOn": "2019-08-24"}'{ "success": true, "window": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "title": "string", "description": "string", "state": "scheduled", "scope": "project", "recurrence": "once", "timezone": "string", "localStartTime": "string", "durationMinutes": 0, "startsOn": "2019-08-24", "endsOn": "2019-08-24", "weekdays": [ 0 ], "monthDay": 0, "occurrenceStartsAt": "2019-08-24T14:15:22Z", "occurrenceEndsAt": "2019-08-24T14:15:22Z", "targets": [ { "type": "service", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08" } ], "statusPageIncidentIds": [ "da6f58bf-0ef2-4571-a37b-e6207b408783" ] }}