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. Specifically, the conversionInfo operation retrieves detailed information about a file conversion process using the file's UUID.

Use cases include:

• Tracking the status and details of file conversions initiated on Uploadcare.
• Automating workflows that depend on conversion metadata or results.
• Integrating Uploadcare’s file conversion capabilities into broader automation pipelines.

For example, after uploading an image file and requesting its conversion to another format, you can use this operation to check the conversion progress and retrieve related data.

Properties

Output

The node outputs a JSON object containing the conversion information for the specified file UUID. This typically includes details such as conversion status, progress, output URLs, and any relevant metadata returned by the Uploadcare API.

No binary data is output by this operation.

Example output structure (simplified):

{
  "status": "completed",
  "result": {
    "uuid": "file-uuid",
    "original_file_url": "...",
    "converted_file_url": "...",
    "conversion_details": { ... }
  }
}

Dependencies

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

Troubleshooting

• Invalid UUID: If the provided UUID does not correspond to a valid file or conversion job, the API will return an error. Verify the UUID is correct and corresponds to an existing file.
• Authentication errors: Ensure the API keys are correctly configured and have sufficient permissions.
• Network issues: Connectivity problems may cause request failures; verify network access to Uploadcare services.
• Unknown operation error: This node supports many operations; ensure the operation parameter is set exactly to "conversionInfo" when intending to retrieve conversion info.

Links and References

• Uploadcare API Documentation
• Uploadcare File Conversion Guide
• Uploadcare JavaScript SDK