AvantGuard - NinjaOne

Overview

This node interacts with the AvantGuard NinjaOne API to retrieve content from a knowledge base folder path. Specifically, the "Get Knowledge Base Folder Path Content" operation allows users to fetch information about the contents of a specified folder within the knowledge base. This is useful for scenarios where you want to programmatically explore or manage knowledge base articles organized in folders, such as displaying folder contents in a dashboard, syncing folder data, or automating documentation workflows.

Practical examples include:

• Fetching all articles or subfolders inside a particular knowledge base folder by specifying its path or ID.
• Integrating knowledge base content retrieval into IT service management or helpdesk automation.
• Building custom views or reports based on folder structures in the knowledge base.

Properties

These parameters allow flexible ways to specify which folder's content to retrieve, either by path or by numeric ID, and optionally scoped by organization.

Output

The node outputs JSON data representing the content of the specified knowledge base folder path. This typically includes metadata about articles and subfolders contained within that folder. The exact structure depends on the API response but generally will contain arrays or objects describing each item’s properties such as name, ID, type (article or folder), and other relevant details.

No binary data output is indicated by the source code.

Dependencies

• Requires an API key credential for AvantGuard NinjaOne to authenticate requests.
• Needs the base URL of the NinjaOne API configured in the credentials.
• Depends on the @avantguardllc/n8n-openapi-node package for OpenAPI integration.
• Uses an OpenAPI specification (openapi.json) bundled with the node for request building.

Troubleshooting

• Common issues:
  • Incorrect or missing API credentials will cause authentication failures.
  • Providing invalid folder paths or IDs may result in empty responses or errors.
  • Network connectivity problems can prevent successful API calls.
• Error messages:
  • Authentication errors typically indicate invalid or expired API keys; verify and update credentials.
  • "Folder not found" or similar errors suggest the folder path or ID does not exist; double-check inputs.
  • Timeout or connection errors require checking network access and API availability.

Links and References

• AvantGuard NinjaOne API Documentation (general reference for API endpoints)
• n8n documentation on creating custom nodes and OpenAPI integration