Update Schedule Rotation

Update the participants and time restrictions of a specific schedule rotation.

Note

Make sure that the API key that's used to create the Opsgenie connection for this card is not team-specific. Otherwise, any input value in the Team ID or Team Name fields on this card will not override the team that's specified by a team-specific API key. It is recommended to create and manage API keys on the Opsgenie API key management page.

Options

Field Definition Type Required
Schedule Identifier Type of schedule identifier for the team. Choose one of the following options:
  • Schedule ID: Unique ID of the schedule.
  • Schedule Name: Name of the schedule.

Dropdown

TRUE

Update Time Restriction? Specify if time restriction is updated. Choose one of the following options:
  • No: No updated time restriction.
  • Time Only: Limit schedule rotation to a time of the week.
  • Day and Time: Limit schedule rotation based on a certain day and time of the week.

Dropdown

TRUE

Input

These fields are dynamically generated based on the fields selected in Options.

Field Definition Type Required

Rotation

Schedule ID Unique ID of the schedule.

This field displays when Schedule ID is selected from Schedule Identifier options.

Text

TRUE

Schedule Name Name of the schedule.

This field displays when Schedule Name is selected from Schedule Identifier option.

Text

TRUE

Rotation ID Unique ID of schedule rotation.

Text

TRUE

Name Name of the rotation.

Text

FALSE

Start Date Start date of the rotation. Date format as yyyy-MM-dd'T'HH:mm:ssZ (for example, 2017-01-15T08:00:00+02:00). Minutes may take 0 or 30 as value. Otherwise they will be converted to nearest 0 or 30 automatically.

Date & Time

FALSE

End Date End date of the rotation. Date format as yyyy-MM-dd'T'HH:mm:ssZ (for example, 2017-01-15T08:00:00+02:00) Minutes may take 0 or 30 as value. Otherwise they will be converted to nearest 0 or 30 automatically.

Date & Time

FALSE

Type

Duration of rotation. Choose one of the following options:

  • Hourly
  • Daily
  • Weekly

Dropdown

FALSE

Length Length of the rotation. Default value is 1.

Number

FALSE

Merge Participants? Indicates whether to merge the existing participants list with the input list. Choose one of the following options:
  • Yes
  • No

Dropdown

FALSE

Participants List of escalations, teams, users or none which are used in a schedule. Each of them can be used multiple times and will be rotated in the order they are given.

For user and team, optionally define ID or username properties.

For example:

Copy
[
{
"type":"escalation",
"id":"3f145401-e6f3-428f-9f3c-41b0e1d172d5",
"name":"Team 2_escalation"
},
{
"type":"user",
"id":"d92b2aa1-4bc8-481b-a30e-4f19e5a27f83",
"username":"johnathan.doe@okta.com"
},
{
"type":"team",
"id":"d00f95c1-2cce-4110-adbc-2ceca786c305",
"username":"lily.doe@okta.com"
},
{
"type":"none"
}
]
Array of Objects

FALSE

Time Restrictions Used to limit schedule rotation to a certain day and time of the week, using multiple start and end times for each day of the week. This allows for applying different scheduling rotations at different times.

This field displays when Time Only or Day and Time is selected from Update Time Restriction? in Options.

Object

TRUE

When Time Only is selected for the Update Time Restrictions? field in Options, the following options are available.

Note: Hours are rounded down, and minutes are rounded to the closest 00/30.

Number

TRUE

  • startHour - 0 to 23

Number

TRUE

  • startMinute - 00 or 30

Number

TRUE

  • endHour - 0 to 23

Number

TRUE

  • endMinute - 00 or 30

Number

TRUE

For example:

Copy
{
"startHour": 5
"startMin": 30
"endHour": 16
"endMin": 0
}
When >Day and Time is selected for the Update Time Restrictions? field Options, the following options are available.

Note: Both day and time options are required.

Array of Objects

TRUE

  • startDay: monday to sunday

Text

TRUE

  • startHour: 0 to 23

Number

TRUE

  • startMinute: 00 or 30

Number

TRUE

  • endDay: monday to sunday

Text

TRUE

  • endHour: 0 to 23

Number

TRUE

  • endMinute: 00 or 30

Number

TRUE

For example:

Copy
[
{
"startDay":"monday",
"endDay":"tuesday",
"startHour":8,
"endHour":18,
"startMin":0,
"endMin":30
},
{
"startDay":"thursday",
"endDay":"sunday",
"startHour":6,
"endHour":8,
"startMin":0,
"endMin":30
}
]

Output

Field Definition Type
Status Code

Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example:

  • A 201 Created status code indicates success where a new resource was created.
  • A 403 Forbidden error indicates that the HTTP request wasn't processed because the necessary permissions were missing.

For a full list of possible status codes, see HTTP status codes.

Number

Result Result of the API call.

For example, Deleted.

Text

Related topics

Opsgenie connector

Workflow elements

Opsgenie API overview