AvantGuard - NinjaOne icon

AvantGuard - NinjaOne

AvantGuard - NinjaOne

Actions159

Overview

This node interacts with the AvantGuard NinjaOne API to retrieve related items associated with a specific entity. The "Get Related Items With Entity" operation allows users to specify an entity type and its ID, then fetch all items related to that entity. This is useful in scenarios where you want to gather contextual or linked information about an entity, such as fetching all documents, contacts, or attachments related to a particular organization or technician.

Practical examples:

  • Retrieve all documents linked to a specific organization.
  • Get all attachments related to a particular technician.
  • Fetch all checklist items associated with a given contact.

Properties

Name Meaning
Rel Entity Type The type of the related entity to query. Options include ORGANIZATION, DOCUMENT, LOCATION, NODE, ATTACHMENT, TECHNICIAN, CREDENTIAL, CHECKLIST, END USER, CONTACT, KB DOCUMENT.
Rel Entity Id The unique identifier (numeric) of the related entity for which to fetch related items.

Output

The node outputs JSON data containing the list of related items associated with the specified entity. Each item in the output typically includes details relevant to the related item, such as its ID, type, name, and other metadata as provided by the AvantGuard NinjaOne API.

If binary data is returned (not explicitly shown in the code), it would represent file attachments or similar content linked to the related items.

Dependencies

  • Requires an API key credential for AvantGuard NinjaOne to authenticate requests.
  • The base URL for the API must be configured in the node credentials.
  • Depends on the @avantguardllc/n8n-openapi-node package and the OpenAPI specification (openapi.json) bundled with the node.

Troubleshooting

  • Invalid Entity Type or ID: Ensure that the "Rel Entity Type" is one of the supported options and that the "Rel Entity Id" is a valid number corresponding to an existing entity.
  • Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Network Issues: Check connectivity to the configured base URL.
  • Empty Results: If no related items are returned, confirm that the entity actually has related items in the system.

Links and References

Discussion