Update an existing on-call schedule.

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

For more information see the API Concepts Document.

External Documentation

To learn more, visit the PagerDuty documentation.

​
Basic Parameters

ParameterDescription
Schedule DescriptionThe description of the schedule.
Schedule IDThe ID of the schedule to update.
Schedule LayersA list of schedule layers.An array of schedule layers containing the following format:- id: - start: This field is required.- end: The end time of this layer. If null, the layer does not end.- users The ordered list of users on this layer. The position of the user on the list determines their order in the layer. This field is required.- restrictions: An array of restrictions for the layer. A restriction is a limit on which period of the day or week the schedule layer can accept assignments. Restrictions respect the time_zone parameter of the request.- rotation_virtual_start: The effective start time of the layer. This can be before the start time of the schedule. This field is required.- rotation_turn_length_seconds: The duration of each on-call shift in seconds. This field is required.- name: The name of the schedule layer.
Schedule NameThe name of the schedule.
Schedule Time ZoneThe time zone of the schedule.

​
Advanced Parameters

ParameterDescription
Final Schedule NameThe name of the subschedule.
Final Schedule Rendered Coverage PercentageThe percentage of the time range covered by this layer. Returns null unless since or until are set.
Final Schedule Rendered Schedule EntriesThis is a list of entries on the computed layer for the current time range. Since or until must be set in order for this field to be populated.
OverflowAny on-call schedule entries that pass the date range bounds will be truncated at the bounds, unless the parameter overflow=true is passed. This parameter defaults to false.For instance, if your schedule is a rotation that changes daily at midnight UTC, and your date range is from 2011-06-01T10:00:00Z to 2011-06-01T14:00:00Z:- If you don’t pass the overflow=true parameter, you will get one schedule entry returned with a start of 2011-06-01T10:00:00Z and end of 2011-06-01T14:00:00Z.- If you do pass the overflow=true parameter, you will get one schedule entry returned with a start of 2011-06-01T00:00:00Z and end of 2011-06-02T00:00:00Z.
Overrides Subschedule NameThe name of the subschedule.
Overrides Subschedule Rendered Coverage PercentageThe percentage of the time range covered by this layer. Returns null unless since or until are set.
Overrides Subschedule Rendered Schedule EntriesThis is a list of entries on the computed layer for the current time range. Since or until must be set in order for this field to be populated.

​
Example Output

{
	"summary": "Response Example",
	"value": {
		"schedule": {
			"description": "Rotation schedule for engineering",
			"escalation_policies": [
				{
					"html_url": "https://subdomain.pagerduty.com/escalation_policies/PT20YPA",
					"id": "PT20YPA",
					"self": "https://api.pagerduty.com/escalation_policies/PT20YPA",
					"summary": "Another Escalation Policy",
					"type": "escalation_policy_reference"
				}
			],
			"final_schedule": {
				"name": "Final Schedule",
				"rendered_schedule_entries": []
			},
			"html_url": "https://subdomain.pagerduty.com/schedules/PI7DH85",
			"id": "PI7DH85",
			"name": "Daily Engineering Rotation",
			"overrides_subschedule": {
				"name": "Overrides",
				"rendered_schedule_entries": []
			},
			"schedule_layers": [
				{
					"id": "PG68P1M",
					"name": "Layer 1",
					"rendered_schedule_entries": [],
					"restrictions": [
						{
							"duration_seconds": 32400,
							"start_time_of_day": "08:00:00",
							"type": "daily_restriction"
						}
					],
					"rotation_turn_length_seconds": 86400,
					"rotation_virtual_start": "2015-11-06T20:00:00-05:00",
					"start": "2015-11-06T20:00:00-05:00",
					"users": [
						{
							"user": {
								"html_url": "https://subdomain.pagerduty.com/users/PXPGF42",
								"id": "PXPGF42",
								"self": "https://api.pagerduty.com/users/PXPGF42",
								"summary": "Regina Phalange",
								"type": "user_reference"
							}
						}
					]
				}
			],
			"self": "https://api.pagerduty.com/schedules/PI7DH85",
			"summary": "Daily Engineering Rotation",
			"teams": [
				{
					"html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8",
					"id": "PQ9K7I8",
					"self": "https://api.pagerduty.com/teams/PQ9K7I8",
					"summary": "Engineering",
					"type": "team_reference"
				}
			],
			"time_zone": "America/New_York",
			"type": "schedule",
			"users": [
				{
					"html_url": "https://subdomain.pagerduty.com/users/PXPGF42",
					"id": "PXPGF42",
					"self": "https://api.pagerduty.com/users/PXPGF42",
					"summary": "Regina Phalange",
					"type": "user_reference"
				}
			]
		}
	}
}

​
Workflow Library Example

Update Schedule with Pagerduty and Send Results Via Email

Preview this Workflow on desktop

Was this page helpful?