File Operations

Performs file and directory operations — including reading, writing, copying, moving, deleting, and listing — on the local file system.

Purpose

Use File Operations when a workflow needs to interact directly with files or directories on the server. It covers the full range of common file-management tasks: checking whether a file exists before processing it, reading its contents into the workflow, writing transformed data back to disk, moving completed files to an archive folder, or gathering a list of files matching a pattern for batch processing.

Inputs

Field	Type	Required	Description
File Path	Text	Yes	The full path to the file or directory to act on.
Operation	Dropdown	Yes	The operation to perform. See the Operations table below.
New Name	Text	No	The new file name (including extension) for the renamed file. Visible when Operation is Rename.
Destination Path	Text	No	The target folder or full file path for copy or move operations. Visible when Operation is Copy or Move.
Content	Text	No	The text to write or append to the file. Visible when Operation is WriteText or AppendText.
Bytes	Text	No	Base64-encoded bytes to write to the file. Visible when Operation is WriteBytes.
Overwrite	Dropdown	No	Whether to replace an existing file at the destination. Visible when Operation is Copy, WriteText, or WriteBytes.
Search Pattern	Text	No	A file-name pattern (e.g. *.txt) used to filter results. Visible when Operation is ListFiles or ListDirectories.
Recursive	Dropdown	No	Whether to include files or directories in sub-folders. Visible when Operation is ListFiles or ListDirectories.

Visibility Rules

New Name is visible when Operation is Rename. Destination Path is visible when Operation is Copy or Move. Content is visible when Operation is WriteText or AppendText. Bytes is visible when Operation is WriteBytes. Overwrite is visible when Operation is Copy, WriteText, or WriteBytes. Search Pattern and Recursive are visible when Operation is ListFiles or ListDirectories.

Operations

Operation	Description
Rename	Renames the file to the value specified in New Name within the same directory.
Copy	Copies the file to Destination Path.
Move	Moves the file to Destination Path.
Delete	Permanently deletes the file at File Path.
Exists	Returns true if a file exists at File Path, or false otherwise.
ReadText	Reads the entire text content of the file and returns it as a string.
WriteText	Writes Content to the file, creating or overwriting it based on the Overwrite setting.
AppendText	Appends Content to the end of the file.
ReadBytes	Reads the file and returns its content as a byte array.
WriteBytes	Writes the provided byte array to the file.
ListFiles	Returns a list of file paths within the directory matching the Search Pattern.
ListDirectories	Returns a list of sub-directory paths within the directory matching the Search Pattern.
CreateDirectory	Creates the directory specified by File Path and returns its full path.
GetAttributes	Returns the file-system attributes of the file as a string.

Outputs

Name	Description
Result	The outcome of the operation. For Rename, Copy, Move, WriteText, WriteBytes, AppendText, and CreateDirectory this is the resulting path. For Delete this is true. For Exists this is a boolean. For ReadText this is the file content as a string. For ReadBytes this is a byte array. For ListFiles and ListDirectories this is a list of paths. For GetAttributes this is a string of attribute flags.

Examples

Check whether a file exists before processing

Field	Value
File Path	C:\Exports\report.csv
Operation	Exists
Result	true or false

List all PDF files in a folder

Field	Value
File Path	C:\Documents\Archive
Operation	ListFiles
Search Pattern	*.pdf
Recursive	False

Copy a file to a processing folder

Field	Value
File Path	C:\Incoming\data.xml
Operation	Copy
Destination Path	C:\Processing
Overwrite	True