Skip to main content

schedules

Overview

Nameschedules
TypeResource
Idpagerduty.schedules.schedules

Fields

NameDatatypeDescription
idstring
namestringThe name of the schedule
descriptionstringThe description of the schedule
_typestringThe type of object being created.
escalation_policiesarrayAn array of all of the escalation policies that uses this schedule.
final_scheduleobject
html_urlstringa URL at which the entity is uniquely displayed in the Web app
overrides_subscheduleobject
schedule_layersarrayA list of schedule layers.
selfstringthe API show URL at which the object is accessible
summarystringA short-form, server-generated string that provides succinct, important information about an object suitable for primary labeling of an entity in a client. In many cases, this will be identical to name, though it is not intended to be an identifier.
teamsarrayAn array of all of the teams on the schedule.
time_zonestringThe time zone of the schedule.
typestringA string that determines the schema of the object. This must be the standard name for the entity, suffixed by _reference if the object is a reference.
usersarrayAn array of all of the users on the schedule.

Methods

NameAccessible byRequired ParamsDescription
get_scheduleSELECTidShow detailed information about a schedule, including entries for each layer and sub-schedule.
Scoped OAuth requires: schedules.read
list_schedulesSELECTList the on-call schedules.

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

For more information see the API Concepts Document

Scoped OAuth requires: schedules.read
create_scheduleINSERTdata__scheduleCreate a new on-call schedule.

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

For more information see the API Concepts Document

Scoped OAuth requires: schedules.write
create_schedule_previewINSERTdata__schedulePreview what an on-call schedule would look like without saving it.

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

For more information see the API Concepts Document

Scoped OAuth requires: schedules.write
delete_scheduleDELETEidDelete an on-call schedule.

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

For more information see the API Concepts Document

Scoped OAuth requires: schedules.write
_get_scheduleEXECidShow detailed information about a schedule, including entries for each layer and sub-schedule.
Scoped OAuth requires: schedules.read
_list_schedulesEXECList the on-call schedules.

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

For more information see the API Concepts Document

Scoped OAuth requires: schedules.read
update_scheduleEXECid, data__scheduleUpdate an existing on-call schedule.

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

For more information see the API Concepts Document

Scoped OAuth requires: schedules.write