team_add
Create one team, an organization on the chart, optionally under another one. Only an administrator edits the organization chart. Creating an organization puts nobody in it; person_update moves people. `workspace_write` · 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/team_add/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "name": "…" } }'{ "toolName": "team_add", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "team", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}task_vocabulary_set POST
Set the task vocabulary: the business and task type labels this company files work under. Each list sent is written at once, so read registeredLabels from a task_list result first and send it back with what changes; a list left out is kept. A label a task still carries cannot be dropped. This is an administrator’s. `workspace_write` · v1
team_delete POST
Remove one team from the organization chart, so that organization is gone. Everybody who belonged to it keeps their directory entry and belongs to no organization until somebody moves them. An organization with organizations under it is refused; remove or move those first. Requires approval; this action is irreversible. `destructive` · approval · v1