task_add
Create a new workspace task with typed task fields. Never ask the user to classify it: send the business when you know it, and the record decides whatever business, type and size is left out from the company definitions. Use this to add a todo or assignment for the requester or another team member. Use task_update for existing work. `workspace_write` · v7
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/task_add/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "title": "draft the quarterly report", "endsAt": "2026-09-05", "participantPersonHints": [ "Sample Lee", "Example Park" ], "size": "M" } }'{ "toolName": "task_add", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "task", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}schedule_update POST
Change explicit fields on a reminder or recurring alert the requester set up, including how often it repeats and when it next arrives. Use schedule_list first when neither the schedule ID nor its current description is known. At least one field to change is required. `workspace_write` · v1
task_board_get POST
Get one task board week: its visible cards, including undated and overdue carry-over work, with direct-child progress across all weeks. Counts describe this board selection; use task_list for complete history and reports. Uses the same person scope and read permissions as task_list. `read` · v1