channel_member_add
Add company members to a channel the requester is in. It is done as the requester, exactly as their messenger screen does it, and refused for the same reasons. `external_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/channel_member_add/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "channelHint": "company-announcements", "personHints": [] } }'{ "toolName": "channel_member_add", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "channel", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}channel_leave POST
Leave a channel the requester is in. The only owner cannot leave; hand the channel over first with channel_owner_update. It is done as the requester, exactly as their messenger screen does it, and refused for the same reasons. `external_write` · v1
channel_member_delete POST
Remove one member from a channel. Only an owner of the channel may do this. An owner cannot be removed. It is done as the requester, exactly as their messenger screen does it, and refused for the same reasons. `external_write` · v1