AvantGuard - NinjaOne icon

AvantGuard - NinjaOne

AvantGuard - NinjaOne

Actions159

Overview

This node integrates with the AvantGuard NinjaOne API to retrieve software query data. Specifically, the "Get Software" operation under the "Queries" resource allows users to fetch a list of software records based on various optional filters and pagination controls. This is useful for IT administrators or security teams who want to audit installed software across devices, track software installation dates, or paginate through large datasets.

Practical examples include:

  • Retrieving all software installed before or after a certain date.
  • Filtering software by device.
  • Controlling the number of results per page and navigating through pages using cursors.

Properties

Name Meaning
Additional Query Parameters Optional parameters to refine the software query:
- Df: Device filter (string)
- Cursor: Cursor name for pagination (string)
- Page Size: Limit number of records per page (number)
- Installed Before: Include software installed before this date (string)
- Installed After: Include software installed after this date (string)

Output

The node outputs JSON data representing the software records retrieved from the API. The structure typically includes an array of software items with details such as software name, version, installation date, and associated device information. Pagination metadata may also be included if applicable.

No binary data output is indicated in the source code.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard NinjaOne API.
  • The base URL for the API must be configured in the node credentials.
  • Uses the @avantguardllc/n8n-openapi-node package and an OpenAPI specification (openapi.json) bundled within the node for request building.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect date formats in "Installed Before" or "Installed After" parameters may result in API errors.
    • Exceeding page size limits or invalid cursor values can lead to pagination errors.
  • Error messages:

    • Authentication errors: Verify that the API key credential is correctly set up.
    • Validation errors on query parameters: Ensure date strings are in the expected format and numeric values like page size are valid.
    • Network or connectivity errors: Check internet connection and API endpoint availability.

Links and References

Discussion