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 provides integration with the Uploadcare API, enabling a wide range of file and metadata management operations. It supports uploading files (single or groups), retrieving file or group information, storing or deleting files/groups, managing metadata, handling webhooks, performing file conversions, and executing addons.
The deleteMetadata operation specifically allows users to delete a metadata key from a file or group identified by its UUID. This is useful for cleaning up or removing obsolete metadata entries associated with stored files.
Common scenarios:
- Removing outdated or incorrect metadata tags from uploaded files.
- Managing file metadata dynamically as part of automated workflows.
- Cleaning metadata before sharing or archiving files.
Example:
You have a file uploaded to Uploadcare with custom metadata keys describing project status. When a project completes, you want to remove the "inProgress" metadata key from the file automatically using this node's deleteMetadata operation.
Properties
| Name | Meaning |
|---|---|
| UUID | The unique identifier of the file or group from which to delete metadata. |
| Metadata Key | The specific metadata key to delete from the file or group. |
Output
The output is a JSON object representing the result of the deleteMetadata API call. Typically, this will confirm successful deletion or provide details if the key did not exist.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for Uploadcare with appropriate permissions.
- Uses Uploadcare's official JavaScript SDK clients (
upload-clientandrest-client) internally. - Needs n8n credentials configured with Uploadcare API public and private keys.
Troubleshooting
Common issues:
- Invalid or missing UUID: Ensure the UUID corresponds to an existing file or group in Uploadcare.
- Nonexistent metadata key: Attempting to delete a key that does not exist may return an error or no-op.
- Authentication errors: Verify that the API keys are correct and have sufficient permissions.
Error messages:
"Unknown operation": Occurs if the operation parameter is incorrectly set; ensure it is exactly"deleteMetadata".- API authentication failures: Check that the API keys are valid and properly configured in n8n credentials.
- Network or API errors: Confirm network connectivity and Uploadcare service availability.