Overview
This node interacts with the Put.io API to perform various file operations such as listing files and folders, retrieving file details, downloading files, creating folders, and uploading files. It is useful for automating file management tasks on Put.io, such as fetching file metadata, downloading files by ID or path, organizing files into folders, and uploading new files programmatically.
Use Case Examples
- Automatically list files in a specific folder to process or analyze them.
- Retrieve detailed information about a file by its ID or path for reporting or integration purposes.
- Download files from Put.io to local storage or other services based on file ID or path.
- Create new folders in Put.io to organize files dynamically during workflows, e.g., by date or project name, and upload files into these folders.
Properties
| Name | Meaning |
|---|---|
| Selection Method | Determines how the file is selected for get or download operations, either by File ID or File Path. |
| File ID | The ID of the file to get or download, used when Selection Method is 'File ID'. |
| File Path | The full path to the file (e.g., /folder/subfolder/file.txt), used when Selection Method is 'File Path'. |
Output
JSON
files- Array of file objects returned when listing files, excluding folders.folders- Array of folder objects returned when listing files.id- File ID returned when getting file details.name- File name returned when getting file details.file_type- Type of the file (e.g., file or folder) returned when getting file details.downloadUrl- URL to download the file, returned when downloading a file.error- Error message returned if an operation fails and continueOnFail is enabled.
Dependencies
- Put.io API
- An API key credential for Put.io
Troubleshooting
- Invalid folder ID error occurs if the folder ID is not a number; ensure the folder ID input is numeric.
- File not found error occurs if the specified file path does not exist; verify the file path is correct and accessible.
- Errors related to missing binary data when uploading files; ensure the binary property name matches the input data and that binary data exists on the input item.
- API request failures due to invalid or missing API credentials; verify the Put.io API key is correctly configured in the node credentials.
Links
- Put.io API Documentation - Official API documentation for Put.io, detailing endpoints and usage.