leave_decide
Approve or reject a leave request. Only an administrator may, and the record refuses anybody else. An approval is what spends the entitlement, so it requires approval from the person asking for it. `workspace_write` · approval · v2
Authorization
memberToken The tools internkim uses inside a company, callable from outside it. A token belongs to a person, and every call runs as that person, so a token can never do more than its owner can.
The first token is made signed in, from the settings screen. After that a token makes its own
successors: POST /token for a new one, DELETE /token for the old one, so a script rotates
without a browser. A token can neither mint a rung above its own nor revoke itself.
Send Authorization: Bearer <token> on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
text/plain
text/plain
text/plain
text/plain
text/plain
text/plain
text/plain
curl -X POST "https://example.com/tools/leave_decide/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "leaveHint": "…", "decision": "approved" } }'{ "toolName": "leave_decide", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "leave", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}leave_balance POST
Read how much leave is left for a year. Use this to answer 'how many days do I have left'. The default scope is the requester; scope all is everybody who works here, which is what reviewing entitlements wants. tracking is unlimited when the company grants no fixed entitlement, and then the day counts are null rather than zero. Somebody whose balance the requester may not read comes back with null day counts rather than failing. `read` · v2
leave_delete POST
Take a leave back out of the record entirely, as though it was never filed. A person takes back their own while it is still waiting on a decision; an administrator takes back anybody's. Entitlement an approved leave spent comes back with it. To refuse a leave rather than erase it, decide it rejected. `destructive` · approval · v2