Move or resize an occurrence Beta
PATCH /api/v1/maintenance/occurrences/{id}
Send from, to or both. The rest of the window's occurrences don't change. PUT does the same thing.
Needs an X-API-Key header whose owner has permission to manage uptime monitors in the app. The call counts once against your daily quota. See Monitoring API: getting started for authentication, rate limits and errors.
- An occurrence that has finished can't be changed (
409). - A changed
fromcan't be in the past, andtocan't be in the past either (400). To drop an occurrence, cancel it instead. - It can't overlap another occurrence of the same window (
409). - It must end after it starts, and last at most 30 days (
400). - If you later change the window's schedule, this change is replaced along with the other future occurrences.
Request
Response
200 · application/json
- {
- "occurrence": { "id": "48214", "maintenanceId": "mw_3f9a0c1d2e4b5a6c7d8e", "description": "Weekly database backup",
- "from": "2026-09-27T03:00:00.000Z", "to": "2026-09-27T04:00:00.000Z", "modified": true },
- "usage": { "used": 38, "dailyLimit": 100, "tier": "free" }
- }
Errors
| Status | When |
|---|---|
400 | from or to isn't a valid time, it wouldn't end after it starts, it would last over 30 days, or it would start (when from changes) or end in the past. |
401 | The API key is missing or invalid. |
403 | The key's owner doesn't have permission to manage uptime monitors, or the key isn't linked to a workspace. |
404 | No occurrence with that id in your workspace, or it has been cancelled. |
405 | The endpoint doesn't accept that method. |
409 | The occurrence has finished, or it would overlap another occurrence of the same window. |
429 | A rate limit or your daily quota was hit. Read Retry-After, in seconds. Writes are also limited to 30 a minute per key. |
500 | Something went wrong on our side. Try again. |
503 | The API is temporarily unavailable. Try again shortly. |
Errors are JSON: { "error": "message" }. See Monitoring API errors.
Related
- Maintenance windows: how maintenance works and the window object
- Cancel an occurrence: drop it instead
- Update the window: change every future occurrence