Create a new on-call rotation

post

https://api.firehydrant.io/v1/teams/{team_id}/on_call_schedules/{schedule_id}/rotations

Add a new rotation to an existing on-call schedule

Path Params

team_id

string

required

schedule_id

string

required

Body Params

name

string

required

The name of the on-call rotation

time_zone

string

required

The timezone of the on-call rotation as a string

description

string | null

The description of the on-call rotation

slack_user_group_id

string | null

The Slack Usergroup ID for the on-call rotation

enable_slack_channel_notifications

boolean | null

Notify the team's Slack channel when handoffs occur

prevent_shift_deletion

boolean | null

Prevent shifts from being deleted by users and leading to gaps in coverage.

coverage_gap_notification_interval

string | null

An ISO8601 duration string specifying that the team should be notified about gaps in coverage for the upcoming interval. Notifications are sent at 9am daily in the rotation's time zone via email and, if enabled, the team's Slack channel.

color

string | null

A hex color code that will be used to represent the rotation in FireHydrant's UI.

members

array of objects | null

An ordered list of objects that specify members of the schedule's rotation.

members

strategy

object

required

An object that specifies how the rotation's on-call shifts should be generated.

restrictions

array of objects | null

A list of objects that restrict the rotation to specific on-call periods.

restrictions

start_time

string | null

An ISO8601 time string specifying when the initial rotation should start. This value is only used if the rotation's strategy type is "custom".

Response

Language

Credentials

Header

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Add a new rotation to an existing on-call schedule