List Maintenance Windows
listMaintenanceWindowsList maintenance windows with schedules, active status, affected monitors, and status pages; filter by title keywords or status to find IDs for updating, activating, or deleting windows.
Instructions
Returns every maintenance window with its schedule, whether it is active, monitorIDs (the monitors it suppresses) and statusPageSlugs (the status pages that announce it). A window with an empty monitorIDs list suppresses nothing. Use it to find the ID that updateMaintenanceWindow, setMaintenanceWindowActive and deleteMaintenanceWindow take; fields returns only the fields you name. Filter by keywords in the title, or by status, e.g. "scheduled,under-maintenance" to leave out ended windows. Returns up to 50 windows per call; pass nextCursor back as cursor for the next page.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "listMaintenanceWindows"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many windows to return (default: 50) | |
| cursor | No | The nextCursor of the previous call, for the next page | |
| fields | No | Only these fields, comma-separated, e.g. "title,active,monitorIDs"; id is always returned. Default: every field. | |
| status | No | Only windows in these statuses, comma-separated: inactive, scheduled, under-maintenance, ended, unknown | |
| keywords | No | Space-separated keywords matched against the window's title, case-insensitively; all must match |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | How many windows this page holds | |
| total | Yes | How many match the filters, across every page | |
| nextCursor | No | Pass as cursor for the next page; absent on the last page | |
| maintenanceWindows | Yes | Array of maintenance windows; with fields, only the fields asked for |