Actions3
Overview
The Symbiosika Sync Knowledge Item node enables synchronization of knowledge items with a Symbiosika Assistant. It supports checking if a knowledge item needs syncing, uploading knowledge files (binary data), or syncing knowledge entries by text. This node is useful in scenarios where you maintain an external knowledge base or document repository and want to keep the Symbiosika Assistant updated automatically.
Practical examples include:
- Automatically syncing updated PDF manuals or documents as knowledge files.
- Syncing textual knowledge entries such as FAQs or help articles.
- Checking whether a knowledge item has changed since the last sync to avoid unnecessary uploads.
Properties
| Name | Meaning |
|---|---|
| Organisation Name or ID | Select or specify the organisation to which the knowledge item belongs. |
| Operation | Choose the action: • Sync Knowledge File • Sync Knowledge Entry By Text Only • Check Knowledge Item If It Should Be Synced |
| Sync-ID (External) | The unique external identifier for the knowledge item to sync or check. |
| Last Change of the Item | The timestamp or date string representing the last modification time of the knowledge item. |
| Binary Property | (For Sync Knowledge File operation) The name of the binary property containing the file data to upload. |
| Knowledge Text | (For Sync Knowledge Entry By Text Only operation) The textual content of the knowledge entry to sync. |
| Knowledge Title | (For Sync Knowledge Entry By Text Only operation) The title of the knowledge entry. |
Output
The node outputs JSON objects representing the response from the Symbiosika API for each processed item:
- For Check Knowledge Item, the output contains information indicating whether the knowledge item exists and if it should be synced.
- For Sync Knowledge File, the output includes the result of uploading the binary file to the assistant.
- For Sync Knowledge Entry By Text Only, the output contains the result of syncing the textual knowledge entry.
If errors occur during processing and "Continue On Fail" is enabled, the output will contain an error field with the error message for that item.
The node does not output binary data itself; it only consumes binary input when syncing knowledge files.
Dependencies
- Requires an API key credential for authenticating with the Symbiosika Chat API.
- The node makes HTTP requests to the Symbiosika API endpoints under the organisation context.
- The organisation list is dynamically loaded via the API using the provided credentials.
- Proper configuration of the API URL and API key in the credentials is necessary.
Troubleshooting
- No binary data found in property "X": Occurs if the specified binary property does not exist on the input item when syncing a knowledge file. Ensure the binary data is correctly attached and the property name matches.
- Failed to load organisations: Indicates issues fetching organisation options, possibly due to invalid API credentials or network problems.
- Operation not supported: Happens if an unsupported operation value is set. Verify the operation parameter is one of the supported options.
- API request errors: Any HTTP or API errors will be thrown unless "Continue On Fail" is enabled, in which case they appear in the output JSON under
error. - Ensure the
externalIdandlastChangefields are correctly set to avoid syncing stale or incorrect data.
Links and References
- n8n Expressions Documentation
- Symbiosika API documentation (not publicly linked here; refer to your Symbiosika account resources)