Read Schedule Rotation

Read 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 Specifies how you identify the schedule. Choose one of the following options:
  • Schedule ID: Unique ID of the schedule rotation.
  • Schedule Name: Name of the schedule rotation.

Dropdown

TRUE

Input

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

Field Definition Type Required
Schedule ID

Unique ID of the schedule.

Displays when Schedule ID is selected from the Schedule Identifier Options.

Text

TRUE

Schedule Name

Name of the schedule.

Displays when Schedule Name is selected from the Schedule Identifier Option.

Text

TRUE

Rotation ID Unique ID of schedule rotation.

Text

TRUE

Output

Field Definition Type
Rotation 160;
ID Unique ID of the schedule rotation.

Object

Name Name of the schedule rotation.

Text

Start Date Start date of the schedule. Format: yyyy-MM-dd'T'HH:mm:ssZ. Minutes may take 0 or 30 as value. Otherwise they will be converted to nearest 0 or 30 automatically.

Date & Time

End Date End date of the tschedule. Format: yyyy-MM-dd'T'HH:mm:ssZ. Minutes may take 0 or 30 as value. Otherwise they will be converted to nearest 0 or 30 automatically.

Date & Time

Type Duration of rotation. Choose one of the following options:
  • Hourly

  • Daily

  • Weekly

Text

Length Specifies the length of the rotation.

For example, if the rotation is hourly and length is 5 then it is a 5-hour rotation.

Number

Participants List of escalations, teams, users or the reserved word none which will be used in schedule. Each of them can be used multiple times and will be rotated in the order they given. Array of Objects
Time Restrictions Used to limit schedule rotation to certain day and time of the week, using multiple start and end times for each day of the week. This allows applying different scheduling rotations at different times.

Object

Related topics

Opsgenie connector

Workflow elements

Opsgenie API overview