get_oncalls
Retrieve current or historical on-call schedules or policies for teams or users. Filter by specific schedules, users, or escalation policies, and define time ranges for accurate on-call tracking.
Instructions
List on-call entries for schedules, policies, or time ranges.
Behavior varies by time parameters:
- Without since/until: Returns current on-calls Example: get_oncalls(schedule_ids=["SCHEDULE_123"])
- With since/until: Returns all on-calls in range Example: get_oncalls(schedule_ids=["SCHEDULE_123"], since="2024-03-20T00:00:00Z", until="2024-03-27T00:00:00Z")
Args:
current_user_context (bool): Use current user's team policies (default: True)
schedule_ids (List[str]): Filter by schedules (optional)
user_ids (List[str]): Filter by users (optional, excludes current_user_context)
escalation_policy_ids (List[str]): Filter by policies (optional)
since (str): Start of query range in ISO8601 format (default: current datetime)
until (str): End of query range in ISO8601 format (default: current datetime, max range: 90 days in the future). Cannot be before since.
limit (int): Max results (optional)
earliest (bool): Only earliest on-call per policy/level/user combo (optional)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| current_user_context | No | ||
| earliest | No | ||
| escalation_policy_ids | No | ||
| limit | No | ||
| schedule_ids | No | ||
| since | No | ||
| until | No | ||
| user_ids | No |