Uploadcare APIInstall

Overview

This node integrates with the Uploadcare API, providing a wide range of file and group management operations such as uploading files, retrieving file information, managing metadata, handling webhooks, and performing file conversions. The getMetadata operation specifically retrieves all metadata associated with a given file or group identified by its UUID.

Common scenarios for using this node include:

• Automating file uploads and management workflows.
• Retrieving detailed metadata about stored files for processing or auditing.
• Managing file groups and their metadata in bulk.
• Integrating Uploadcare's file storage and transformation capabilities into larger automation pipelines.

For example, using the getMetadata operation, you can fetch all custom metadata attached to a specific file UUID to decide further processing steps based on that data.

Properties

Note: The UUID property is required for the getMetadata operation and other related operations like fileInfo, storeFile, deleteFile, etc.

Output

The output JSON contains the metadata object retrieved from Uploadcare for the specified UUID. This typically includes key-value pairs representing custom metadata fields attached to the file or group.

Example output structure (conceptual):

{
  "key1": "value1",
  "key2": "value2",
  ...
}

No binary data output is produced by the getMetadata operation.

Dependencies

• Requires an API key credential for Uploadcare with both public and private keys.
• Uses the official Uploadcare JavaScript SDK packages (@uploadcare/upload-client and @uploadcare/rest-client) bundled within the node.
• The node expects proper configuration of these credentials in n8n to authenticate API requests.

Troubleshooting

• Invalid UUID: If the provided UUID does not exist or is malformed, the API will return an error. Verify the UUID format and existence in your Uploadcare account.
• Authentication errors: Ensure that the API keys are correctly configured and have sufficient permissions.
• Unknown operation error: This node throws an error if an unsupported operation is requested. Confirm that the operation parameter is set to getMetadata when intending to retrieve metadata.
• Network issues: Connectivity problems may cause request failures; check network access and API availability.

Links and References

• Uploadcare API Documentation
• Uploadcare JavaScript SDK
• n8n Documentation - Creating Custom Nodes