circle_channel_add
Company circles: Add a private messenger channel of the circle's own. Its members are exactly the circle's, kept so as people join and leave the circle, and nobody adds or removes anyone by hand. A circle has at most one channel. Only administrators add one. `workspace_write` · approval · 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/circle_channel_add/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "circleID": "…", "name": "…" } }'{ "toolName": "circle_channel_add", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "circle", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}channel_owner_update POST
Hand a channel over: the person named becomes its owner and the requester stays as a plain member, which only another owner can undo. Only an owner of the channel may do this. It is done as the requester, exactly as their messenger screen does it, and refused for the same reasons. Requires approval. `external_write` · approval · v1
circle_channel_delete POST
Company circles: Delete the circle's messenger channel, so nobody reads or writes in it again. Takes the channel's exact current name from circle_list as confirmation and refuses any other. Only administrators delete one, and the circle itself stays. `destructive` · approval · v1