> Documentation index for AI agents: https://docs.pagerduty.com/llms.txt

# Schedules_v3

Shift-Based Schedules API. Creates and manages on-call schedules using a rotation and event model.


<!-- theme: info -->

> **Important note:** Shift-based schedules use the V3 API and are not compatible with V2 automations. **To create automations for Shift-Based Schedules, you need to:**
>
> 1. **Update your automations** to use the V3 API for all new shift-based schedules
> 2. **Keep the V2 endpoint** for your existing schedules
>
> An upgrade tool for existing schedules is coming soon; your legacy schedules will keep working in the meantime. [Learn more](https://support.pagerduty.com/main/docs/shift-based-schedules-api-upgrade-examples).

- [List schedules](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/list-schedules-v3.md) — `GET /v3/schedules`
- [Create a schedule](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/create-schedule-v3.md) — `POST /v3/schedules`
- [Get a schedule](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/get-schedule-v3.md) — `GET /v3/schedules/{id}`
- [Delete a schedule](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/delete-schedule-v3.md) — `DELETE /v3/schedules/{id}`
- [Update a schedule](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/update-schedule-v3.md) — `PUT /v3/schedules/{id}`
- [List audit records for a schedule](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/list-schedules-audit-records-v3.md) — `GET /v3/schedules/{id}/audit/records`
- [List custom shifts](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/list-custom-shifts.md) — `GET /v3/schedules/{id}/custom_shifts`
- [Create custom shifts](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/create-custom-shifts.md) — `POST /v3/schedules/{id}/custom_shifts`
- [Get a custom shift](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/get-custom-shift.md) — `GET /v3/schedules/{id}/custom_shifts/{custom_shift_id}`
- [Delete a custom shift](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/delete-custom-shift.md) — `DELETE /v3/schedules/{id}/custom_shifts/{custom_shift_id}`
- [Update a custom shift](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/update-custom-shift.md) — `PUT /v3/schedules/{id}/custom_shifts/{custom_shift_id}`
- [List overrides](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/list-overrides.md) — `GET /v3/schedules/{id}/overrides`
- [Create overrides](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/create-overrides.md) — `POST /v3/schedules/{id}/overrides`
- [Get an override](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/get-override.md) — `GET /v3/schedules/{id}/overrides/{override_id}`
- [Delete an override](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/delete-override.md) — `DELETE /v3/schedules/{id}/overrides/{override_id}`
- [Update an override](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/update-override.md) — `PUT /v3/schedules/{id}/overrides/{override_id}`
- [List rotations](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/list-rotations.md) — `GET /v3/schedules/{id}/rotations`
- [Create a rotation](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/create-rotation.md) — `POST /v3/schedules/{id}/rotations`
- [Get a rotation](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/get-rotation.md) — `GET /v3/schedules/{id}/rotations/{rotation_id}`
- [Delete a rotation](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/delete-rotation.md) — `DELETE /v3/schedules/{id}/rotations/{rotation_id}`
- [List events](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/list-events.md) — `GET /v3/schedules/{id}/rotations/{rotation_id}/events`
- [Create an event](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/create-event.md) — `POST /v3/schedules/{id}/rotations/{rotation_id}/events`
- [Get an event](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/get-event.md) — `GET /v3/schedules/{id}/rotations/{rotation_id}/events/{event_id}`
- [Delete an event](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/delete-event.md) — `DELETE /v3/schedules/{id}/rotations/{rotation_id}/events/{event_id}`
- [Update an event](https://docs.pagerduty.com/developer/api/reference/rest/schedules_v3/update-event.md) — `PUT /v3/schedules/{id}/rotations/{rotation_id}/events/{event_id}`

## Developer Agreement

Your access to and use of the PagerDuty Developer Services is governed by the [PagerDuty Developer Agreement](https://docs.pagerduty.com/developer/pagerduty-developer-agreement).