OnCall

A team's header figures and recent paging record

get/api/{org_id}/oncall/teams/{team_id}/overview

Request

Path parameters

org_idstring required

Organization name

team_idstring required

Team ID

Query parameters

daysinteger

Window for the summary (default 7, max 366)

Response

Success

acked_under_5m_percentinteger nullable

Pages acknowledged within five minutes, as a whole percent of the pages that were acknowledged at all. None when nothing was acknowledged — a zero would read as "we are slow" rather than "nothing happened".

alerts_assignedinteger required

Alert rules whose own oncall_team field names this team.

"Assigned" and not "owned" on purpose. Alerts that would reach this team through one of its ownership rules are not counted and not approximated: an alert's identity dimensions are not known until it fires, so at rest there is nothing to match a rule against.

covered_nowboolean required

A page raised right now would reach somebody.

Asks the default slot, not every slot, and so is deliberately not !on_call_now.is_empty(). A team whose secondary is staffed and whose primary is not wakes nobody when the alert fires, so reporting it as covered would be a badge that lies and would disagree with /coverage-gaps and /config-risks.

daysinteger required
frominteger required

Micros, inclusive.

membersinteger required
on_call_nowstring[] required

Everybody on call in any slot — the wider question, kept wide on purpose. This is who to show; covered_now is whether a page lands.

ownership_pathsinteger required

Identity-dimension paths this team owns.

A separate number because an ownership rule is a path, not an alert rule: k8s-cluster=prod is one row here and may catch a thousand alerts or none. Folding the two into one "owns N" would state something that is not true of either.

team_idstring required
team_namestring required
timezonestring required
tointeger required

Micros, exclusive.

Changes

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