Create and manage maintenance windows in PagerDuty to suppress alerts during planned work

domain: developer.pagerduty.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create a maintenance window: POST /maintenance_windows with start_time (ISO 8601), end_time (ISO 8601), a description, and a services array listing the service IDs to suppress during the window
  2. List active maintenance windows: GET /maintenance_windows?filter=ongoing to retrieve currently active windows and their associated services
  3. Update a window's end time: PUT /maintenance_windows/{id} to extend or shorten an active maintenance window without deleting and recreating it
  4. Delete a maintenance window: DELETE /maintenance_windows/{id} to end suppression immediately if work completes early
  5. Create recurring maintenance windows: the PagerDuty API does not natively support recurring windows — implement a scheduler (cron job, Terraform scheduled run, or GitHub Actions schedule) to create windows ahead of each planned maintenance slot
  6. Verify suppression is active: POST a test alert to the affected service's Events API endpoint during the window and confirm no incident or notification is generated

Known gotchas

Related routes

Wire PagerDuty alert grouping (Intelligent, Content-Based, and Unified) to reduce incident noise
support.pagerduty.com · 6 steps · unrated
Trigger, acknowledge, and resolve incidents using the PagerDuty Events API v2
developer.pagerduty.com · 5 steps · unrated
Route security alerts to on-call via the PagerDuty Events API v2
developer.pagerduty.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans