Actions8
Overview
This node integrates with CloudConvert, a versatile file conversion and processing service. It allows users to perform various file-related operations such as converting files between formats, creating thumbnails, merging multiple files into one PDF, adding watermarks, optimizing/compressing files, extracting metadata, capturing website screenshots or PDFs, and creating archives.
Common scenarios include:
- Converting documents, images, audio, or video files to different formats.
- Generating thumbnails for images or videos.
- Merging multiple PDFs into a single document.
- Adding watermarks to protect or brand files.
- Compressing files to reduce size for storage or sharing.
- Extracting metadata from media files for cataloging.
- Capturing website snapshots as images or PDFs.
- Creating ZIP or RAR archives from multiple files.
Practical example: A user can upload an image in PNG format and convert it to JPG while simultaneously generating a thumbnail for quick previews.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with CloudConvert API. Options: OAuth2 (Recommended), API Key |
| Operation | The action to perform on the file(s). Options: Add Watermark, Capture Website, Convert File, Create Archive, Create Thumbnail, Get Metadata, Merge Files, Optimize File |
| Output Format | Desired output file format for applicable operations (convert, merge, archive, thumbnail, capture-website) |
| Binary Input Data | Whether to use binary data from input for the file to process (true/false) |
| Input File Content | Text content of the file to upload if not using binary data |
| Input Filename | Filename including extension for the input file |
| Binary Property | Name of the binary property containing the file data when using binary input |
| Additional Options | JSON dictionary of extra options for the CloudConvert job, allowing advanced customization |
Additional operation-specific fields are loaded dynamically depending on the selected operation, such as watermark settings or capture website parameters.
Output
The node outputs JSON data representing the result of the chosen operation. This typically includes information about the processed file(s), such as URLs to download converted files, metadata extracted, or confirmation of completed tasks.
If the operation involves file data, the node may also output binary data corresponding to the processed files, enabling further workflow steps to access or store these files.
Dependencies
- Requires a valid CloudConvert API authentication method: either OAuth2 credentials or an API key.
- Network access to CloudConvert's API endpoints.
- No additional environment variables are explicitly required beyond the configured credentials.
Troubleshooting
- Invalid operation error: Occurs if an unsupported operation is selected. Ensure the operation parameter matches one of the supported options.
- Authentication failures: Check that the provided OAuth2 token or API key is valid and has sufficient permissions.
- File input issues: If using binary input, verify the binary property name matches the actual input data field. For text input, ensure the content and filename are correctly specified.
- API request errors: May arise due to network issues or invalid additional options JSON. Validate JSON syntax and network connectivity.
- Continue on Fail: If enabled, errors will be returned as part of the output JSON instead of stopping execution, useful for handling partial failures gracefully.