OnCall

Update an on-call team

put/api/{org_id}/oncall/teams/{team_id}

Request

Path parameters

org_idstring required

Organization name

team_idstring required

Team ID

Request body

descriptionstring nullable

Needs double_option: #[serde(default)] decodes an explicit null to the outer None.

namestring nullable
timezonestring nullable

Response

Success

channel_destinationsstring[] nullable

Alert Destination names this team is talked to on — the room the record is posted to, as opposed to the people the ladder wakes.

None means never set and falls back to EscalationPolicy::destinations, so stored policies keep working; Some([]) means deliberately no channel. Precedence lives in config::meta::oncall::policy::team_channel.

On the team rather than the policy because a team's room is not a property of its ladder — you want it without editing a rung — and a whole-row super-cluster snapshot built from Team would otherwise have to carry a column it cannot see.

created_atinteger required
descriptionstring nullable
idstring required
namestring required
org_idstring required
slack_channel_idstring nullable
slack_channel_namestring nullable

Display only.

slack_enterprise_idstring nullable

Slack Enterprise Grid id of the team's room, if any; matched with slack_workspace_id by the Slack app's team rule (D45).

slack_same_room_destinationstring nullable

The team's webhook destination that posts to the same Slack room.

slack_workspace_idstring nullable

Slack team id of the team's room, set by /o2 oncall here (RO-1).

timezonestring required

IANA name, used to render schedules in the team's own working hours. Stored, not interpreted — resolution is in absolute micros.

updated_atinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.