Overview
This node allows users to upload files directly to the Narratheque platform by sending binary file data to its API. It is useful for automating the process of adding documents or media files into Narratheque companies, especially in workflows where files are generated or processed dynamically and need to be stored or indexed in Narratheque.
Practical examples include:
- Automatically uploading scanned documents or images from a workflow into Narratheque.
- Integrating file storage with Narratheque as part of a content management or archival system.
- Sending media files collected from other sources (e.g., forms, sensors) into Narratheque for further processing or cataloging.
Properties
| Name | Meaning |
|---|---|
| Narratheque Choice | Selects the predefined Narratheque API endpoint region: "Europe" (https://api.narratheque.io) or "Canada" (https://api.narratheque.ca). |
| Custom Install | Boolean toggle to use a custom Narratheque API URL instead of the predefined options. |
| Custom URL | The custom Narratheque API base URL to use when "Custom Install" is enabled. |
| Binary Property | The name of the binary property in the input data that contains the file to upload. Defaults to "data". |
Output
The node outputs an array with one item per input item. Each output item has a json field containing:
status: A string indicating the file was uploaded via binary.response: The full response data returned from the Narratheque API after uploading the file.
The node does not output any binary data itself; it only returns JSON metadata about the upload result.
Dependencies
- Requires an API authentication token credential for Narratheque (an API key or token).
- Uses the
axioslibrary to perform HTTP POST requests. - Uses the
form-datalibrary to construct multipart/form-data payloads for file uploads. - Requires the binary data to be present on the input under the specified binary property.
Troubleshooting
- Missing or incorrect binary property: If the specified binary property does not exist or does not contain valid binary data, the node will fail. Ensure the input items have the correct binary property set.
- Invalid or missing API token: Authentication errors may occur if the API token credential is missing, expired, or invalid. Verify the API token configuration.
- Incorrect URL or network issues: Using an incorrect custom URL or having network connectivity problems can cause request failures. Double-check the URL and network access.
- File size or format restrictions: The API might reject files that are too large or unsupported formats. Check Narratheque API documentation for limits.
- Error messages from API: The node surfaces the API response in the output. Review the
responsefield for detailed error messages from Narratheque.
Links and References
- Narratheque API Documentation (official docs linked in node description)