circle_update
Company circles: Create or edit a circle. id is its lowercase English name, such as sales-team, and never changes; name is what people read and is given only to a circle the company made, since the product names its default circles in every language. readableCategories names the data room categories its members read, and a parent grants all descendants. Members change access immediately, so read circle_list and confirm who is affected first. A circle confers no administrative or editing rights. `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_update/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "id": "…", "readableCategories": [] } }'{ "toolName": "circle_update", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "circle", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}circle_member_update POST
Company circles: Set the circles an active member belongs to, replacing them atomically. Only administrators place people in circles. A member gains each circle's workspace folder, memory and data room categories, and joins its channel when it has one. `workspace_write` · approval · v1
company_document_classify POST
Classify a document against the company data room taxonomy in one model request. Supply its title and extracted text or a factual summary. The result is an exact permitted leaf category code, including a parent without children, or X when ambiguous. Parents with children are never choices. Classify before uploading and registering a new document. `computation` · v1