← All toolsFiles & Documentsdocx_handlerAll editions

READ_DOCX

Reads a .docx file and extracts headings, paragraphs, tables, and metadata into clean Markdown. Returns word count and page estimate.

Parameters

NameTypeRequiredDescription
pathstringyesAbsolute path to the .docx file

How to use it

You normally trigger this by describing what you want in chat — the agent selects READ_DOCX automatically. For example:

Try saying
“read my docx handler”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "docx_handler",
  "action": "READ_DOCX",
  "args": {
    "path": "/Users/me/Documents/file.txt"
  },
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"READ_DOCX","args":{"path":"/Users/me/Documents/file.txt"}}'

Part of the docx_handler plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.