Create one or more overrides

Create one or more overrides, each for a specific user covering a specified time range. If you create an override on top of an existing override, the last created override will have priority.

A Schedule determines the time periods that users are On-Call.

Note: An older implementation of this endpoint only supported creating a single ocverride per request. That functionality is still supported, but deprecated and may be removed in the future.

For more information see the API Concepts Document

Scoped OAuth requires: schedules.write

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the resource.

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"

Request Body

application/json

The overrides to be created

TypeScript Definitions

Use the request body type in TypeScript.

overrides?array<>

Response Body

`application/json`

curl -X POST "https://api.pagerduty.com/schedules/{id}/overrides" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "Content-Type: application/json" \  -d '{    "overrides": [      {        "start": "2012-07-01T00:00:00-04:00",        "end": "2012-07-02T00:00:00-04:00",        "user": {          "id": "PEYSGVA",          "type": "user_reference"        },        "time_zone": "UTC"      },      {        "start": "2012-07-03T00:00:00-04:00",        "end": "2012-07-04T00:00:00-04:00",        "user": {          "id": "PEYSGVF",          "type": "user_reference"        },        "time_zone": "UTC"      }    ]  }'

[  {    "status": 201,    "override": {      "start": "2021-03-09T05:00:00Z",      "end": "2021-03-09T17:00:00Z",      "user": {        "id": "P37CSDJ",        "type": "user_reference",        "summary": "Scott",        "self": "https://api.pd-staging.com/users/P37CSDJ",        "html_url": "https://pdt-braythwayt.pd-staging.com/users/P37CSDJ"      },      "id": "Q3X6MJ1LUKD6QW"    }  },  {    "status": 201,    "override": {      "start": "2021-03-10T05:00:00Z",      "end": "2021-03-10T17:00:00Z",      "user": {        "id": "P37CSDJ",        "type": "user_reference",        "summary": "Scott",        "self": "https://api.pd-staging.com/users/P37CSDJ",        "html_url": "https://pdt-braythwayt.pd-staging.com/users/P37CSDJ"      },      "id": "Q37A85CJZP1DTT"    }  },  {    "status": 400,    "errors": [      "Override must end after its start"    ],    "override": {      "start": "2021-03-11T05:00:00Z",      "end": "2021-03-11T05:00:00Z",      "user": {        "id": "P37CSDJ",        "type": "user_reference",        "summary": "Scott",        "self": "https://api.pd-staging.com/users/P37CSDJ",        "html_url": "https://pdt-braythwayt.pd-staging.com/users/P37CSDJ"      }    }  }]

Create one or more overrides

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`