Overview
This node integrates with the Koncile.ai service to upload files for processing based on specified templates and folders. It is designed to send binary file data from incoming workflow items to Koncile.ai, associating each file with a chosen folder and template within the Koncile system.
Common scenarios where this node is beneficial include automating document processing workflows such as OCR, data extraction, or classification by leveraging Koncile.ai’s capabilities. For example, you might use this node to automatically upload scanned invoices or contracts stored as binary data in your workflow to Koncile.ai for further analysis or archiving.
Properties
| Name | Meaning |
|---|---|
| Binary Property | The name of the binary property in the input item that contains the file to be uploaded. |
| Folder Name or ID | Select or specify the target folder in Koncile.ai where the file will be uploaded. |
| Template Name or ID | Select or specify the template in Koncile.ai that defines how the uploaded file should be processed. |
- Folder Name or ID and Template Name or ID are selectable from dynamically loaded options fetched from Koncile.ai via API calls.
- The template options depend on the selected folder.
Output
The node outputs an array with one item per input, each containing a JSON object with the response from Koncile.ai after uploading the file. The output JSON includes all fields returned by the Koncile.ai API plus an additional field:
uploaded_file_name: The original filename of the uploaded binary file.
No binary data is output by this node; it only returns metadata about the upload operation.
Dependencies
- Requires an API key credential for authenticating with Koncile.ai.
- Uses HTTP requests to Koncile.ai endpoints:
- To fetch folders:
GET https://api.koncile.ai/v1/fetch_all_folders/ - To upload files:
POST https://api.koncile.ai/v1/upload_file/
- To fetch folders:
- The node depends on n8n's helper methods for handling binary data and HTTP requests.
- The user must configure the API key credential in n8n before using this node.
Troubleshooting
Error: No binary data property 'X' found on input
This error occurs if the specified binary property does not exist on the input item. Ensure that the binary property name matches exactly the property containing the file data.HTTP request failures (e.g., authentication errors, network issues)
These may occur if the API key is invalid, missing, or if there are connectivity problems. Verify the API key credential and network access to Koncile.ai.Empty folder or template lists
If no folders or templates appear in the dropdowns, check that the API key has sufficient permissions and that the Koncile.ai account has configured folders and templates.
Links and References
- Koncile.ai API Documentation (assumed base URL from code)
- n8n Expressions Documentation – for using expressions in property fields