Create a maintenance window

Create a new maintenance window for the specified services. No new incidents will be created for a service that is in maintenance.

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.write

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

From*string

The email address of a valid user associated with the account making the request.

Formatemail

Request Body

application/json

The maintenance window object.

TypeScript Definitions

Use the request body type in TypeScript.

maintenance_window*

Response Body

`application/json`

curl -X POST "https://example.com/maintenance_windows" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "From: user@example.com" \  -H "Content-Type: application/json" \  -d '{    "maintenance_window": {      "type": "maintenance_window",      "start_time": "2015-11-09T20:00:00-05:00",      "end_time": "2015-11-09T22:00:00-05:00",      "description": "Immanentizing the eschaton",      "services": [        {          "id": "PIJ90N7",          "type": "service_reference"        }      ]    }  }'

{  "maintenance_window": {    "id": "PW98YIO",    "type": "maintenance_window",    "summary": "Immanentizing the eschaton",    "self": "https://api.pagerduty.com/maintenance_windows/PW98YIO",    "html_url": "https://subdomain.pagerduty.com/service-directory/maintenance-windows/PW98YIO",    "sequence_number": 1,    "start_time": "2015-11-09T20:00:00-05:00",    "end_time": "2015-11-09T22:00:00-05:00",    "description": "Immanentizing the eschaton",    "services": [      {        "id": "PIJ90N7",        "type": "service_reference",        "summary": "My Mail Service",        "self": "https://api.pagerduty.com/services/PIJ90N7",        "html_url": "https://subdomain.pagerduty.com/service-directory/PIJ90N7"      }    ],    "teams": [      {        "id": "PQ9K7I8",        "type": "team_reference",        "summary": "Engineering",        "self": "https://api.pagerduty.com/teams/PQ9K7I8",        "html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8"      }    ],    "created_by": {      "id": "PXPGF42",      "type": "user_reference",      "summary": "Earline Greenholt",      "self": "https://api.pagerduty.com/users/PXPGF42",      "html_url": "https://subdomain.pagerduty.com/users/PXPGF42"    }  }}

Create a maintenance window

Authorization

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`