Update an on-call schedule's rotation

patch

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

Update an on-call schedule's rotation by ID

Path Params

rotation_id

string

required

team_id

string

required

schedule_id

string

required

Body Params

name

string | null

The name of the on-call rotation

description

string | null

The description of the on-call rotation

time_zone

string | null

The timezone of the on-call rotation as a string

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

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.

prevent_shift_deletion

boolean | null

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

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 | null

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

effective_at

string | null

An ISO8601 time string specifying when the updated schedule should take effect. This value must be provided if editing an attribute that would affect how the schedule's shifts are generated, such as the time zone, members, strategy, or restrictions.

Response

Language

Credentials

Header

Response

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

application/json

200Update an on-call schedule's rotation by ID