Move
FileTools
Description
Move or rename files and directories with atomic operations! The Move tool enables precise file organization - from simple renames to complex moves across drive boundaries.
With optional overwrite control and automatic creation of the destination directory, you have full control over your file operations. Perfect for file workflows, archiving, and automated file distribution.
Why This Tool Stands Out
- Results depend on input, configuration and implementation. Verify behavior in your environment; no accuracy, security or performance guarantee is established here.
- Rename Support built-in
- Overwrite Control configurable
- Cross-Device across drives
Perfect for:
System administrators who archive files; developers who distribute build artifacts; data processors who move files between processing steps; and anyone who wants to automate their file structure. Ideal for ETL processes and file workflows.
Workflow support; time savings depend on the task
Instead of manually copying files, pasting them at the destination, and deleting them at the source, move with a single API call - atomic, safe, and with immediate confirmation.
JSON Parameters
- sourcePath REQUIRED (String)The full path of the source file or directory. Example: "C:\\Temp\\data.txt"
- destinationPath REQUIRED (String)The full destination path. Can be a new file name or a destination directory. Example: "D:\\Archive\\data.txt"
- overwrite OPTIONAL (Boolean)If true, an existing destination file is overwritten. If false, the operation fails if the destination exists. Default: false
Example Call
{
"tool": "Move",
"params": {
"sourcePath": "C:\\Downloads\\report.pdf",
"destinationPath": "D:\\Archive\\2024\\report.pdf",
"overwrite": false
}
}
Return Values
The tool returns an object with the following properties:
- success (Boolean)
True if the move was successful - sourcePath (String)
The original path of the file/folder - destinationPath (String)
The new path after the move - wasRenamed (Boolean)
Indicates whether only the name was changed - error (String, optional)
Error message if the move failed
Example Usage
Step-by-step guide:
- Specify the path of the source file or directory
- Define the destination path (new location or new name)
- Decide whether existing files should be overwritten
- The tool performs the move atomically
- Check the return values to confirm successful execution
Related Tools
Ready to Organize Your Files?
Use Move for atomic file operations and efficient workflows. Integrate it into your automation now!
Discover All FileTools