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 wide range of file and group management operations such as uploading files (single or groups), retrieving file info, storing or deleting files, managing metadata, handling webhooks, performing file conversions, and executing addons. It is useful in scenarios where you need to automate file uploads, metadata management, or file processing workflows within n8n.
For the specific operation getMetadataValue under the default resource, the node retrieves the value of a specified metadata key for a given file or group identified by its UUID. This is beneficial when you want to programmatically access custom metadata associated with your uploaded files or groups, for example, fetching tags, descriptions, or other custom attributes stored as metadata.
Properties
| Name | Meaning |
|---|---|
| UUID | The unique identifier (UUID) of the file or group from which to retrieve the metadata. |
| Metadata Key | The key name of the metadata entry whose value you want to retrieve. |
Output
The output JSON contains the value of the requested metadata key for the specified UUID. The exact structure depends on the Uploadcare API response but generally includes the metadata value associated with the key.
If the node supports binary data output for other operations, it would represent file content or related binary information, but for getMetadataValue, the output is purely JSON containing metadata information.
Example output snippet:
{
"value": "example metadata value"
}
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. - No additional environment variables are required beyond the API credentials configured in n8n.
Troubleshooting
Common issues:
- Invalid or missing UUID: Ensure the UUID corresponds to an existing file or group in Uploadcare.
- Incorrect metadata key: Verify that the metadata key exists for the specified UUID.
- Authentication errors: Confirm that the API credentials are correctly set up and have sufficient permissions.
Error messages:
"Unknown operation": Occurs if an unsupported operation is selected; ensuregetMetadataValueis chosen.- API errors related to authorization or resource not found will be returned from Uploadcare and should be checked against your account and input parameters.