mail_connection_start
Start the mail account connection flow and return setup instructions for the requester. Requires the user to be present (RequiresUserPresence=true). Only call this when mail_connection_status reports mail is not connected. `connect` · approval · presence · v1
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/mail_connection_start/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": {} }'{ "toolName": "mail_connection_start", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "mail", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}leave_update POST
Correct a leave that was filed wrong: its days, its kind, how much entitlement it consumes, or the note. A person corrects their own while it is still waiting on a decision; an administrator corrects anybody's at any time, which is how a leave filed for the wrong year is moved to the right one. Only the fields you pass change. `workspace_write` · approval · v2
mail_connection_status POST
Check the mail connection: whether the requester's email account is connected. Answers this when a mail call has failed for want of an account, or when none has been made yet. `read` · v1