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 manage files and groups stored on Uploadcare's platform. Specifically, the storeFiles operation allows users to store multiple files identified by their UUIDs in batch. This is useful when you have uploaded files that are not yet permanently stored and want to finalize their storage in one action.
Common scenarios include:
- Batch storing multiple uploaded files after an upload process.
- Managing file lifecycle by explicitly marking files as stored.
- Automating workflows where multiple files need to be confirmed as stored before further processing.
Example: After uploading several files via other operations or external means, you can use this node’s storeFiles operation to mark all those files as stored by providing their UUIDs.
Properties
| Name | Meaning |
|---|---|
| UUIDs | Array of file UUIDs to be stored in batch. Used for batch operations like storeFiles, deleteFiles, and uploadFileGroup. |
Output
The output is a JSON object representing the response from the Uploadcare API for the storeFiles operation. It typically contains information about the stored files, such as their UUIDs and status confirming they are now stored.
No binary data output is produced 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 proper configuration of the Uploadcare API credentials in n8n.
Troubleshooting
- Error: "Unknown operation" — This occurs if an unsupported operation name is provided. Ensure the operation parameter is set correctly to
storeFiles. - Invalid UUIDs — If the UUIDs array contains invalid or non-existent file identifiers, the API call may fail. Verify that the UUIDs are correct and correspond to existing files.
- Authentication errors — If the API keys are missing or incorrect, the node will fail to authenticate. Check that the Uploadcare API credentials are properly configured.
- Empty UUIDs array — Providing an empty list of UUIDs will likely result in no action or an error. Make sure to supply at least one valid UUID.