Overrides are used to make manual one-time adjustments to on-call schedules. If a user is sick, goes on vacation, or would like to swap on-call periods with someone else, an override is our recommended solution.
Scheduling an override creates an override layer over the existing schedule. Scheduled overrides are displayed beneath your schedule layers, as the lowest layer before the Final Schedule (the lowest layer always takes precedence).
Creating overrides in the web UI
There are three places to schedule overrides on existing schedules in PagerDuty.
Override a specific shift on a schedule
Scheduling an override by clicking directly on the shift you'd like to override will pre-populate the override window with the effective dates and times, without you having to manually punch them in.
- Access your schedules from the web UI by going to Configuration > Schedules
From the Schedules page or from the individual schedule's viewing page, click directly on the shift that you would like to override. If need be, you can tab forward by days, weeks, and months to locate the shift you would like to override.
The Schedule an Override window will be pre-populated with the times of the shift that you just clicked. Make the necessary changes to the Person you're adding for the override and click Create Override.
The override will immediately appear on the schedule
Override any span of time on a schedule
Navigate to Schedules.
Click on the gear for the desired on-call schedule and select Schedule an Override.
- Or you can click into a schedule and select Schedule an Override:
The override window will be a pop-up. Select the Person and start/end times of the override. Click Create Override when complete.
Creating overrides using the API
An example Python script to schedule overrides for a user going on vacation can be found here: create_vacation_overrides.py
To learn more about how to interact with the PagerDuty API, we recommend checking out the collection of scripts our community has created on our Knowledge Base. Our developer docs also provide more information on creating and deleting overrides using the REST API.
Deleting an Override
You can delete upcoming overrides on your schedule in the event that the override is no longer needed. If an override is deleted during the middle of the scheduled shift, the regular schedule will resume from the time of the override's deletion. You cannot delete past overrides; only present or future ones.
To delete an override:
While on the Schedules page, click on the name of the schedule or select View after clicking on the gear for the schedule you would like to change.
In the Upcoming Overrides list, click the X to delete the override.