document_read
Read a workspace document and return Markdown content. path takes an exact /workspace path, or an attachment's exact url copied verbatim from the conversation — a document attached to an earlier message is fetched by that url. Never invent a filesystem path from a url. Use image_read for image files. `read` · 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/document_read/invoke" \ -H "Content-Type: application/json" \ -d '{ "input": { "path": "shared/reports/q3.md" } }'{ "toolName": "document_read", "outcome": "succeeded", "selectedBackend": "device", "result": { "…": "the tool's own document" }}