get_oncalls
Retrieve on-call entries for schedules, policies, or time ranges. Returns current on-calls or those within a specified range.
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")
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| current_user_context | No | Use current user's team policies (default: True) | |
| schedule_ids | No | Filter by schedules (optional) | |
| user_ids | No | Filter by users (optional, excludes current_user_context) | |
| escalation_policy_ids | No | Filter by policies (optional) | |
| since | No | Start of query range in ISO8601 format (default: current datetime) | |
| until | No | End of query range in ISO8601 format (default: current datetime, max range: 90 days in the future). Cannot be before `since`. | |
| limit | No | Max results (optional) | |
| earliest | No | Only earliest on-call per policy/level/user combo (optional) | |
| include | No | List of fields to include in the response. If specified, only these fields will be returned for each on-call entry |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||