team_update
Rename one team, move that organization under another one, or change where it sits among its siblings. Only the fields the call names change, and only an administrator edits the organization chart. Moving an organization under one of its own descendants is refused. `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_update/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "teamHint": "…" } }'{ "toolName": "team_update", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "team", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}team_list POST
Every team in the company — the organizations the organization chart holds — in the order it shows them, each with the organization it sits under and how many people belong to it. Call this before naming an organization in another call, and when an organization hint was refused with candidates to choose between. `read` · v1
Make a token POST
Issues a token to the same person as the one calling. `permission` defaults to the calling rung and may not reach past it. Omitting `name` takes the first ordinal nobody holds. A token expires after `expiresInDays`, 90 when omitted and at most 365; an expired one is renewed by making another by the same name. The `token` field is shown this once and never again.