GET /maintenance_windows
List existing maintenance windows, optionally filtered by service and/or team, or whether they are from the past, present or future.
A Maintenance Window is used to temporarily disable one or more Services for a set period of time.
For more information see the API Concepts Document
Scoped OAuth requires: services.read
Servers
- https://api.pagerduty.com
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Accept |
String | Yes |
The Default value: "application/vnd.pagerduty+json;version=2" |
Content-Type |
String | Yes |
Possible values:
Default value: "application/json" |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
query |
String | No |
Filters the result, showing only the records whose name matches the query. |
limit |
Integer | No |
The number of results per page. |
include |
String | No |
Array of additional Models to include in response. Possible values:
|
filter |
String | No |
Only return maintenance windows in a given state. Possible values:
|
service_ids[] |
Array | No |
An array of service IDs. Only results related to these services will be returned. |
team_ids[] |
Array | No |
An array of team IDs. Only results related to these teams will be returned. Account must have the |
offset |
Integer | No |
Offset to start pagination search results. |
total |
Boolean | No |
By default the See our Pagination Docs for more information. Default value: false |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.