Get maintenance windows
get_maintenance_periodsRead-onlyIdempotent
List the one-off maintenance windows on a monitor, the ones with a fixed start and end. Alerts are suppressed while a window is active. For windows that repeat on a schedule, use get_recurring_maintenance_periods instead. Times are in the team timezone. See https://ohdear.app/docs/api/maintenance-windows.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of windows to return (default: 50). Upcoming windows come back soonest first; past ones most recent first. | |
| monitor_id | Yes | The ID of the monitor to list maintenance windows for | |
| only_active_or_upcoming | No | Only return windows that are running now or start in the future |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| monitor | Yes | ||
| view_url | Yes | ||
| team_timezone | Yes | ||
| maintenance_periods | Yes | One-off maintenance periods. | |
| maintenance_periods_count | Yes |