Actions159
- Related Items Actions
- Backup Actions
- Queries Actions
- Get Disk Drives
- Get Operating Systems
- Get RAID Controller Report
- Get Volumes
- Get Computer Systems
- Get Antivirus Status Report
- Get Device Health Report
- Get Custom Fields Report
- Get Installed Software Patches
- Get Custom Fields Detailed Report
- Get Installed OS Patches
- Get Pending Failed Rejected OS Patches
- Get RAID Drive Report
- Get Windows Services Report
- Get Antivirus Threats
- Get Device Usage
- Get Network Interfaces
- Get Processors
- Get Software
- Get Last Logged On Users Report
- Get Policy Overrides 1
- Get Scoped Custom Fields Report
- Get Pending Failed Rejected Software Patches
- Get Scoped Custom Fields Detailed Report
- System Actions
- Knowledge Base Articles Actions
- Get Knowledge Base Article Signed Urls
- Get Related Item Attachments Signed Urls
- Download Knowledge Base Article
- Get Knowledge Base Folder Path Content
- Upload Temp Attachments
- Get Knowledge Base Folder Content
- Get Client Knowledge Base Articles
- Upload Knowledge Base Articles
- Get Global Knowledge Base Articles
- Download Related Item Attachment
- Organization Documents Actions
- Document Templates Actions
- Checklist Templates Actions
- Organization Checklists Actions
- Location Actions
- Management Actions
- Get Custom Fields Policy Condition
- Delete Policy Condition
- Reset Alert
- Update Device
- Request Scripting Options
- Submit OS Patch Scan
- Get Installer For Location
- Get Windows Event Policy Conditions
- Create Organization
- Cancel Device Maintenance
- Reboot Devices
- Set Windows Service Configuration
- Create Location For Organization
- Update Node Role Policy Assignment For Organization
- Create Windows Event Policy Condition
- Node Approval Operation
- Control Windows Service
- Remove Device Owner
- Submit OS Patch Apply
- Get Installer
- Create Policy
- Get Windows Event Policy Condition
- Update Device Maintenance
- Reset Policy Overrides
- Set Device Owner
- Submit Software Patch Scan
- Update Location
- Reset Alert Set Activity Data
- Get Device Link
- Run Script On Device
- Submit Software Patch Apply
- Update Organization
- Create Custom Fields Policy Condition
- Get Custom Fields Policy Conditions
- Custom Fields Actions
- Ticketing Actions
- Organization Actions
- Devices Actions
- Get Device Active Jobs
- Get Device Installed Software Patches
- Get Device Processors
- Update Node Attribute Values
- Get Device Disk Drives
- Get Device Pending Failed Rejected OS Patches
- Get Device Volumes
- Get Device Alerts
- Get Device Network Interfaces
- Get Device Software
- Get Device Activities
- Get Device Last Logged On User
- Get Device Services
- Get Policy Overrides
- Get Device
- Get Device Installed OS Patches
- Get Device Pending Failed Rejected Software Patches
- Get Node Custom Fields
- Groups Actions
- Webhooks Actions
Overview
This node enables uploading knowledge base articles to a specified system via an API. It is useful for automating the process of adding or updating articles in a knowledge base, which can help organizations maintain up-to-date documentation, FAQs, or support content without manual intervention.
Typical use cases include:
- Automatically importing batches of knowledge base articles from external sources.
- Updating existing articles programmatically based on changes in source data.
- Organizing articles into folders or under specific organizational units.
For example, a support team could use this node to upload new troubleshooting guides directly from their content management system into their customer support portal's knowledge base.
Properties
| Name | Meaning |
|---|---|
| Additional Body Fields | Optional fields to customize the upload request. Includes: |
| - Organization Id | Numeric ID specifying the organization under which the article should be uploaded. |
| - Folder Id | Numeric ID of the folder where the article will be stored. |
| - Folder Path | String path representing the folder hierarchy for storing the article. |
| - Files | JSON array describing the files (articles) to upload, including metadata like content type and disposition. |
The "Files" property expects a JSON structure that defines the content and metadata of each article file to be uploaded.
Output
The node outputs JSON data representing the response from the API after attempting to upload the knowledge base articles. This typically includes information about the success or failure of the upload, IDs of created or updated articles, and any relevant metadata returned by the service.
If the node supports binary data output (not evident from the provided code), it would represent the actual content of uploaded files or related attachments.
Dependencies
- Requires an API key credential for authenticating with the target knowledge base service.
- The node uses a base URL configured in the credentials to send HTTP requests.
- Depends on the
@avantguardllc/n8n-openapi-nodepackage for building properties and handling OpenAPI-based requests. - The node expects the user to provide properly structured JSON for the "Files" property to correctly upload articles.
Troubleshooting
- Invalid or missing API credentials: Ensure the API key or authentication token is correctly set in the node credentials.
- Malformed JSON in "Files": The "Files" property must be valid JSON matching the expected schema; otherwise, the API may reject the request.
- Incorrect folder or organization IDs: Using invalid numeric IDs for organization or folder fields can cause errors; verify these values exist in the target system.
- Network or API errors: Check connectivity and API endpoint availability if uploads fail unexpectedly.
- Error messages from API: Typically indicate issues with authorization, validation of input data, or server-side problems. Review the error details returned in the node output for guidance.
Links and References
- AvantGuard NinjaOne API Documentation (example placeholder, replace with actual)
- n8n Documentation on Creating Custom Nodes
- OpenAPI Specification