message_send
Send a message to a direct message, channel, or the current conversation after approval. attachments uploads workspace files with the message. For targetType=channel, name the channel with channelName; only pass a channelID a tool result gave you. Never answer the person you are replying to with this tool — the final reply is delivered for you. To correct a sent message, use message_update. `external_send` · approval · v3
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/message_send/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "targetType": "directMessage", "message": "today\'s meeting moves to 3pm", "personHint": "Sample Lee" } }'{ "toolName": "message_send", "outcome": "succeeded", "selectedBackend": "device", "effects": [ { "objectType": "message", "effect": "created", "id": "7a93de11-…" } ], "result": { "…": "the tool's own document" }}message_search POST
Find messages in an exact conversation scope, or read known ones in full. Searching by queries returns message IDs with a short preview around the match. Passing messageIDs instead returns those messages complete, which is what you need before rewriting or summarising a long message rather than a phrase inside it. `read` · v2
message_update POST
Change a message the assistant or the requester wrote. To correct it, pass oldText, one exact span copied verbatim from a message_search preview or from the message you sent, and newText; the rest stays untouched, and oldText must appear exactly once or the call fails without changing anything and returns the message as it currently reads, so retry with a span copied from that. To rewrite it, pass text, which replaces the whole message; read it in full first with message_search messageIDs. This is the tool for every correction to something you already posted: when the user points out a mistake, fix that message instead of posting a correction as a new one. It runs immediately without asking the user to confirm. attachments uploads workspace files into the edited message; pass it alone to add a file, such as an inbound image original, without changing the text. `external_write` · v3