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_unpin POST
Unpin a channel from the requester's own channel list, so it goes back to its place among the other channels. `workspace_write` · 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