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 media management operations. Specifically for the convert operation, it allows users to perform file conversions using Uploadcare's conversion service by specifying a conversion type and transformation paths.
Common scenarios where this node is beneficial include:
- Automating image or document format conversions in workflows.
- Applying transformations such as resizing, cropping, or filtering images before further processing or storage.
- Monitoring the status of ongoing conversion jobs.
For example, you can convert an uploaded image to a different format or apply multiple transformations by specifying the appropriate conversion type and transformation paths.
Properties
| Name | Meaning |
|---|---|
| Conversion Type | The type of conversion to perform (e.g., image format conversion). |
| Paths | An array of transformation paths defining the specific transformations to apply. |
Output
The node outputs JSON data containing the response from the Uploadcare API related to the conversion request. This typically includes details about the conversion job, such as job ID, status, and URLs to the converted files.
If binary data is involved (not typical for the convert operation), it would represent the actual file content after conversion, but this operation primarily returns metadata and job information.
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) bundled within the node. - No additional environment variables are needed beyond the API credentials configured in n8n.
Troubleshooting
- Unknown operation error: Occurs if an unsupported operation value is provided. Ensure the operation parameter is set correctly to "convert" or other supported values.
- API authentication errors: Verify that the Uploadcare API credentials are correctly configured and have sufficient permissions.
- Invalid conversion type or paths: Make sure the conversion type and transformation paths are valid according to Uploadcare's API documentation.
- Network or API downtime: Temporary failures may occur due to network issues or Uploadcare service interruptions; retrying later might help.