Update Schedule

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

Parameter	Description
Schedule Description	The description of the schedule.
Schedule ID	The ID of the schedule to update.
Schedule Layers	A 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. usersThe 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 Name	The name of the schedule.
Schedule Time Zone	The time zone of the schedule.

Advanced Parameters

Parameter	Description
Final Schedule Name	The name of the subschedule.
Final Schedule Rendered Coverage Percentage	The percentage of the time range covered by this layer. Returns null unless since or until are set.
Final Schedule Rendered Schedule Entries	This 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.
Overflow	Any 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 Name	The name of the subschedule.
Overrides Subschedule Rendered Coverage Percentage	The percentage of the time range covered by this layer. Returns null unless since or until are set.
Overrides Subschedule Rendered Schedule Entries	This 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