File Store

The filestore node lists, reads, writes, appends, deletes, moves, or checks files in the managed file area.

Paths are relative to the platform file-storage root. Attempts to escape the allowed root are sanitized.

Properties

Property	Purpose
Name	Flow label.
Action	Fixed action, or Auto to require msg.action.
Path	Default relative file or directory path.
Destination	Target path for Move / Rename.
Encoding	UTF-8, Base64, or Binary for read and write actions.

Runtime Inputs

Field	Purpose
msg.action	Selects the action in Auto mode and overrides a configured action.
msg.payload.path	Overrides Path.
msg.payload.content	Content for Write or Append.
msg.payload.destination	Target for Move / Rename.
msg.payload.encoding	Overrides Encoding.

Actions

Action	Output in msg.payload
List files	Array with name, path, size, directory flag, and update time.
Read file	File content in the selected encoding.
Write file	null on success; existing content is overwritten.
Append to file	null on success; creates the file when needed.
Delete file	null on success. Directories may be removed recursively.
Move / Rename	null on success.
Check if exists	Boolean.

Write creates missing parent directories through the managed file service.

Safety

Delete can remove a directory recursively. Validate paths and authorization before exposing file actions to user input or an agent skill.

Errors

Failures are passed to done(err) and can be handled by a Catch node. Common causes include a missing file, invalid path, or unavailable file service.