On-call schedules
An on-call schedule defines who is responsible for responding at any point in time. When an alert fires, escalation policies resolve the current on-call user from computed shifts stored for each schedule.
Schedules sit at the foundation of Incido's alerting pipeline. Escalation policies describes how routing chooses policies; On-call overview describes your personal landing view.
Create a schedule
- Open Teams under On-call and choose the owning team.
- Select Add schedule when schedule limits allow (see Teams and rosters).
- Or use Create team (quick start), which creates a primary schedule as part of setup.
After save you land on the schedule view page. Configure rotations on Rotations and overrides.
Schedule fields
| Field | Purpose |
|---|---|
| Name | Human-readable label in the Dashboard. |
| Key | Stable identifier for API access and configuration import/export. |
| Timezone | How handoffs, time restrictions, and day-of-month boundaries are interpreted. Pick the timezone your operators use to reason about shift changes. |
| Description | Optional notes for administrators. |
| Available for on-call | When enabled, the schedule can be used in escalation policies and alerting. When disabled, configuration is kept but alerting ignores the schedule. The schedule view infolist may show this as Enabled. |
| Shift verification | Per-schedule override for shift-start confirmation: Inherit organization default, Enabled, or Disabled. See Shift verification. |
Schedule calendar
Schedule calendar in the page header opens a full-width week grid of computed coverage.
- Each block shows rotation name and the on-call user's email.
- Color indicates which rotation layer owns the shift. Schedule-wide override windows use a neutral slate tone.
- The calendar uses the same rules as alerting. Use it to spot gaps or overlaps.
- Closing the panel does not change configuration.
Subscribe in your calendar
Share Calendar opens Subscribe in your calendar with a calendar subscribe URL.
- Copy the URL.
- Paste it into Google Calendar, Apple Calendar, or any client that supports subscribed calendars (often From URL).
- The feed is read-only. It lists computed shifts for a rolling window: 31 days in the past through 6 weeks ahead, aligned with alerting.
- Your calendar app refreshes on its own schedule. Incido does not push instant updates when you edit a rotation.
Security
- The URL contains a secret token. Anyone with the full link can read shift times. Share only with people allowed to see coverage.
- The link is not on the public status page, not in the REST API, and not included in configuration export.
Invalidate calendar URL (requires permission to edit the schedule) generates a new secret immediately. Old subscriptions stop updating. Copy the new URL and re-subscribe.
Users who may only view the schedule can copy the current URL. Only users who may edit the schedule can invalidate it.
On the schedule view page
Besides rotations (documented in Rotations and overrides), the schedule view includes:
- Overrides — temporary coverage changes.
- Effective shift history — audit log of duty segments. See Rotations and overrides.
- Recent verifications — shift-start confirmation attempts when verification is enabled. See Shift verification.
Configuration import and export
Configuration transfer includes schedules, rotations, members, time restrictions, and overrides.
- Existing schedules match by key on import.
- Member assignments resolve by email; the target organization needs the same users.
- Subscribe URLs and secrets never travel with export. After import, existing schedules keep their iCal secret in that environment; newly created schedules get a fresh secret on first create.
Operational effects
Schedule changes affect who receives alerts. Coverage updates within seconds as computed shifts refresh after saves.
Coordinate changes with your team, especially when removing members or disabling rotations, to avoid coverage gaps.
Troubleshooting
The iCal feed is empty. Confirm the schedule is Available for on-call. A disabled schedule returns a valid but empty feed. If enabled, check computed shifts via Schedule calendar or Shifts on a rotation (Rotations and overrides).
You need a subscribe link but none is shown. A secret is normally created with the schedule. Someone who can edit the schedule can use Invalidate calendar URL once to generate a link, then copy it from the same dialog.
Alerts ignore this schedule. Confirm Available for on-call is on, rotations have members, and an escalation policy references this schedule or the owning team.