List Time Off Requests
list_pto_requestsLists time off and leave requests, or reads one by its id. With from and to it lists leave that overlaps those days, earliest start first; with status approved that shows who is out. What is listed follows the person's role: their own requests, their reports' for a manager, everyone's for someone who approves any leave. Answers questions like "who is out this week?", "what leave is pending approval?", or "what is my time-off history?".
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_pto_requests"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Return this one request under `request`, by the id an earlier list result gave. The other arguments are then ignored. | |
| to | No | Only leave that starts on or before this day, YYYY-MM-DD, inclusive. | |
| from | No | Only leave that ends on or after this day, YYYY-MM-DD. | |
| limit | No | Max results (default 20) | |
| status | No | Filter by status. | |
| user_id | No | Filter to one person by user ID. Results never go beyond the requests the connected person's role lets them see. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | No | ||
| request | No | Set when id is given | |
| requests | No |