leave_request
File a leave request. It is filed as requested and grants nothing until somebody decides it. Whether the leave is paid and whether it consumes the entitlement follow from the kind, so do not ask the requester for either. It is the requester's own leave unless personHint names somebody else, which only an administrator may do. `workspace_write` · 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_request/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "kind": "…", "startsAt": "2026-09-01", "endsAt": "2026-09-05", "days": 1 } }'{ "toolName": "leave_request", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "leave", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}leave_list POST
List leave in the record. Use this to answer 'when am I off', 'who is away next week', or 'what have I not had decided yet'. It reads the requester's own leave unless personHints names other people or scope is all. registeredKinds in the result names the leave types this company offers, which is what leave_request takes. `read` · v2
leave_return_early POST
Return to work early, before the leave was due to end. The leave the requester is on stops at this moment, the entitlement it no longer spends comes back to them, and they are clocked in. Use it when somebody who is away says they are back; clocking in on an ordinary day is attendance_add. It is the requester's own leave and nobody else's. shortened is false when no leave was covering the moment, and they are clocked in either way. `workspace_write` · v1