leave_delete
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
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_delete/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "leaveHint": "…" } }'{ "toolName": "leave_delete", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "leave", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}leave_decide POST
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
leave_grant_set POST
Set how much leave one person is entitled to in a year. Only an administrator may, and the record refuses anybody else. The number replaces every grant they hold, so 'give them three more days' is read with leave_balance first and written as the total. Somebody who has never been given a number of their own holds the company's annual grant, which company_settings_get answers as leaveDays. Requires approval; an entitlement is what every later leave is spent against. `workspace_write` · approval · v1