conversation_hide
Hide the requester's direct conversation with one person from their own conversation list. Nothing is deleted and nobody else is affected; conversation_reveal shows it again. `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/conversation_hide/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "personHint": "Sample Lee" } }'{ "toolName": "conversation_hide", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "message", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}Keep my picture POST
The picture the member set on their messenger, or when there is none the gradient the app draws from their email, sent in the `file` field of `multipart/form-data` as PNG, JPEG, WebP, GIF, HEIC or HEIF and kept as that member's picture. A notification cannot draw, so it can only show a picture that is kept. A picture kept through this endpoint is replaced by a new one; a picture set anywhere else, or the same picture again, is left as it is and `kept` is `false`.
conversation_reveal POST
Show a direct conversation the requester hid with conversation_hide in their conversation list again. `external_write` · v1