On-Call Command Reference

Manage your on-call rotations, create automated schedules, and view your calendar—all directly from Slack. All commands start with /oncall

Show Current On-Call

Display who is currently on-call for your workspace. Shows the engineer's name and when they started their on-call shift.

/oncall

Example

/oncall
  • Shows current on-call engineer
  • Displays when shift started
  • Quick at-a-glance status
  • Works in any channel

Set On-Call Engineer

Assign a team member as the current on-call engineer. This updates the on-call status and optionally notifies your configured channel.

/oncall @username

Example

/oncall @sarah
  • Sets new on-call engineer
  • Records previous on-call's shift
  • Notifies configured channel
  • Tracks who made the change

Create Rotation Schedule

Create an automated on-call rotation with your team. List engineers in rotation order and optionally set the shift duration in days (defaults to 7).

/oncall schedule @u1 @u2 ... [days]

Example

/oncall schedule @alice @bob @charlie 7
  • Define rotation order
  • Set shift duration (days)
  • Automatic handoffs
  • Timezone-aware scheduling

View Schedule Configuration

View your current on-call schedule configuration, including the list of engineers, rotation duration, and when the schedule started.

/oncall schedule

Example

/oncall schedule
  • See engineers in rotation
  • View rotation duration
  • Check schedule start date
  • Current rotation position

View On-Call Calendar

See the upcoming on-call calendar showing who's on-call and when. Displays the next 8 shifts with dates and times.

/oncall calendar

Example

/oncall calendar
  • View upcoming shifts
  • See exact dates & times
  • Plan ahead for coverage
  • 8-shift lookahead

Add Engineer to Rotation

Add a new engineer to your on-call rotation. They'll be added to the end of the current rotation order.

/oncall schedule add @user

Example

/oncall schedule add @newengineer
  • Add to rotation end
  • No disruption to current schedule
  • Automatic rebalancing
  • Immediate availability

Remove Engineer from Rotation

Remove an engineer from the on-call rotation. If they're currently on-call, the rotation advances to the next person.

/oncall schedule remove @user

Example

/oncall schedule remove @oldmember
  • Remove from rotation
  • Handles current on-call
  • Automatic adjustment
  • Graceful transition

Change Shift Duration

Update how long each on-call shift lasts. Change from weekly to daily rotations or any custom duration.

/oncall schedule duration <days>

Example

/oncall schedule duration 14
  • Change rotation frequency
  • Daily to monthly shifts
  • Takes effect immediately
  • Recalculates calendar

Set Rotation Start Date

Set or change when your rotation schedule begins. Use this to align rotations with your team's schedule.

/oncall schedule start <date>

Example

/oncall schedule start 2024-01-01
  • Set schedule start
  • Align with sprints
  • Recalculates all shifts
  • ISO date format

View On-Call History

See the history of on-call rotations for your workspace. Shows who was on-call, when their shift started and ended, and how many incidents they handled.

/oncall history

Example

/oncall history
  • View past on-call rotations
  • See shift duration
  • Track incidents per rotation
  • Audit trail for compliance

On-Call Analytics

Pro

View analytics about your on-call rotations. See metrics like average incidents per rotation, total on-call hours, and more. Defaults to 30 days.

/oncall analytics [days]

Example

/oncall analytics 7
  • View on-call metrics
  • Track incidents per engineer
  • See total on-call hours
  • Customizable time range

Set Notification Channel

Configure which channel receives notifications when the on-call engineer changes. Great for keeping your team informed of rotation changes.

/oncall channel #channel

Example

/oncall channel #engineering
  • Set notification channel
  • Automatic rotation announcements
  • Keep team informed
  • One-time configuration

Quick Reference

Copy and paste these commands to get started.

$/oncall
$/oncall @username
$/oncall schedule @u1 @u2 ... [days]
$/oncall schedule
$/oncall calendar
$/oncall schedule add @user
$/oncall schedule remove @user
$/oncall schedule duration <days>
$/oncall schedule start <date>
$/oncall history
$/oncall analytics [days]Pro
$/oncall channel #channel

Ready to try it out?

Add Incident/Ops to your Slack workspace and start managing on-call rotations in seconds.