Uploadcare API
Actions27
- uploadFile
- uploadFileGroup
- uploadFromUrl
- uploadFromUploaded
- uploadDirect
- uploadMultipart
- fileInfo
- storeFile
- storeFiles
- deleteFile
- deleteFiles
- copyFileToLocalStorage
- copyFileToRemoteStorage
- groupInfo
- deleteGroup
- updateMetadata
- getMetadata
- getMetadataValue
- deleteMetadata
- createWebhook
- updateWebhook
- deleteWebhook
- convert
- conversionJobStatus
- conversionInfo
- executeAddon
- addonExecutionStatus
Overview
The node integrates with the Uploadcare API to perform various file and group upload operations, as well as file management tasks. Specifically, the uploadFileGroup operation allows users to upload multiple files as a group in one batch. This is useful when you want to organize several related files together under a single group identifier for easier management and retrieval.
Common scenarios include:
- Uploading a set of images or documents that belong to the same project or category.
- Batch uploading files from different binary properties or by referencing existing file UUIDs.
- Grouping files for subsequent processing or sharing as a collective unit.
For example, you might have multiple binary file inputs in an incoming workflow item and want to upload all those files at once as a group to Uploadcare, receiving a group UUID in response.
Properties
| Name | Meaning |
|---|---|
| Binary Properties (Array) | Comma-separated list of binary property names containing files to upload as a group. |
| UUIDs | Array of file UUIDs to include in the group upload (alternative to binary properties). |
Output
The output JSON contains the response from the Uploadcare API after performing the group upload. This typically includes metadata about the newly created file group such as its UUID, creation date, and details about the files within the group.
If binary data is involved, it is handled internally during upload but not directly outputted by this operation.
Dependencies
- Requires an API key credential for Uploadcare with both public and private keys.
- Uses Uploadcare's official JavaScript SDK packages (
@uploadcare/upload-clientand@uploadcare/rest-client) bundled within the node. - The node expects binary data to be available on specified input properties if uploading files directly from binary content.
Troubleshooting
- Empty or incorrect binary property names: If the specified binary properties do not exist or contain no data, the upload will fail. Ensure the binary property names are correct and contain valid file data.
- Invalid or missing UUIDs: When using UUIDs to specify files for group upload, ensure they are valid and correspond to existing files in Uploadcare.
- API authentication errors: Verify that the API credentials are correctly configured and have sufficient permissions.
- Unknown operation error: This node supports many operations; ensure the operation parameter is set exactly to
"uploadFileGroup"for this functionality. - Network or API rate limits: Large batch uploads may hit API limits; consider splitting into smaller groups if errors occur.