Page a responder

An existing workplace team’s owner or admin can define a responder order. Daily/weekly handoffs use an IANA time zone and local clock, preserving the chosen local time through daylight-saving changes.

notify oncall create --team team_... --name Primary \
  --members user_a,user_b,user_c --period weekly \
  --handoff 09:00 --timezone America/New_York

If startsAt is absent, the first responder’s shift begins at the most recent handoff. A timed override replaces the rotation during its window; members can schedule their own coverage. Group reads include current and upcoming shifts.

A new page contacts the current responder, or the entire group if no responder is scheduled. Configured escalation continues until an acknowledgement stops it:

The default schedule contacts the next responder after five minutes, then the group ten minutes later. Repeated dedupKey values join an existing open page and increment repeatCount without issuing another initial page.

notify page ocg_example_maintenance "Cold-room temperature above threshold" \
  --body "Sensor reports 12°C since 14:02" --dedup-key cold-room-temperature

A service can route a message to a rotation using oncall. Its owner must belong to that workplace team. Do not combine it with deviceIds, group, or response. The webhook Idempotency-Key becomes the page deduplication key.

{
  "title": "Cold-room monitor",
  "body": "Temperature above threshold for 5 minutes",
  "oncall": "ocg_example_maintenance"
}

The page response includes pageId and provider-acceptance count delivered. Keep the body within 2,000 characters. CLI equivalents are notify page and notify send --oncall.

A current teammate can acknowledge through a supported Lock Screen action, the app, or the website. The first accepted acknowledgement stops escalation; later acknowledgements are refused. Notify requests clearing the other devices’ alerts. Escalate immediately advances to the next step.

When the incident is finished, resolve it on the website or with notify pages resolve page_... --note "Maintenance completed". Resolution also stops escalation on a page that was never acknowledged.