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
This node integrates with the Uploadcare API, providing a comprehensive set of file and group management operations. It allows users to upload files (including multipart and URL-based uploads), manage file groups, retrieve information about files or groups, store or delete files/groups, handle metadata, manage webhooks, perform file conversions, and execute addons.
The groupInfo operation specifically retrieves detailed information about a file group identified by its unique Group ID (UUID). This is useful when you want to inspect the contents or metadata of an existing group of uploaded files.
Practical examples:
- Fetching details of a group of images uploaded together to display in a gallery.
- Checking the status or metadata of a batch upload grouped under one identifier.
- Managing file groups programmatically within automated workflows.
Properties
| Name | Meaning |
|---|---|
| Group ID | The UUID of the file group to retrieve information for. Used in groupInfo and deleteGroup operations. |
Output
The output is a JSON object containing the response from the Uploadcare API for the requested operation.
For the groupInfo operation, the JSON output includes detailed information about the specified file group, such as:
- Group UUID
- List of files in the group with their metadata
- Creation date and other group-level attributes
The exact structure depends on the Uploadcare API's group info response format.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for Uploadcare with both public and private keys.
- Uses the official Uploadcare JavaScript clients (
@uploadcare/upload-clientand@uploadcare/rest-client) internally. - The node expects these credentials to be configured in n8n prior to use.
Troubleshooting
Common issues:
- Invalid or missing Group ID: The operation requires a valid UUID; ensure the Group ID is correctly provided.
- Authentication errors: Verify that the API keys are correctly set up and have sufficient permissions.
- Network or API downtime: Check connectivity and Uploadcare service status if requests fail.
Error messages:
"Unknown operation": Indicates an unsupported operation was selected; ensure "groupInfo" is chosen.- API errors returned from Uploadcare will be passed through; check the error message for details like invalid UUID or permission denied.