list_oncalls
Retrieve on-call schedules with filters for users, escalation policies, services, and time ranges to identify who is on call.
Instructions
List on-call schedules with optional filtering.
Args:
time_zone: Time zone for date rendering (e.g. America/New_York)
user_ids: Filter by user IDs
escalation_policy_ids: Filter by escalation policy IDs
schedule_ids: Filter by schedule IDs
service_ids: Filter by service IDs. Resolves each service to its escalation policy to find on-call responders.
since: Start of time range
until: End of time range
earliest: Return only earliest oncall per user/policy combination. Defaults to True.
limit: Max results to return
Returns:
List of on-call schedules matching the query parameters
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_oncalls"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| since | No | ||
| until | No | ||
| earliest | No | ||
| user_ids | No | ||
| time_zone | No | ||
| service_ids | No | ||
| schedule_ids | No | ||
| escalation_policy_ids | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| response | Yes |