← All toolsFiles & Documentsfile_managerAll editions

WRITE_FILE

Create a new file or write/append content to an existing file.

Parameters

NameTypeRequiredDescription
pathstringyesAbsolute file path
contentstringyesText content to write
modestring—'write' (overwrite, default) or 'append'

How to use it

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

Try saying
“use file manager to write …”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "file_manager",
  "action": "WRITE_FILE",
  "args": {
    "path": "/Users/me/Documents/file.txt",
    "content": "…",
    "mode": "…"
  },
  "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":"WRITE_FILE","args":{"path":"/Users/me/Documents/file.txt","content":"…","mode":"…"}}'

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