← All toolsFiles & Documentsxlsx_handlerAll editions

APPEND_XLSX

Appends rows to an existing Excel or CSV file without overwriting existing data.

Parameters

NameTypeRequiredDescription
pathstringyesAbsolute path to the existing .xlsx or .csv file
dataarrayyesList of dictionaries representing new rows to append

How to use it

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

Try saying
“use xlsx handler to append …”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "xlsx_handler",
  "action": "APPEND_XLSX",
  "args": {
    "path": "/Users/me/Documents/file.txt",
    "data": []
  },
  "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":"APPEND_XLSX","args":{"path":"/Users/me/Documents/file.txt","data":[]}}'

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