AvantGuard - CIPP icon

AvantGuard - CIPP

AvantGuard - CIPP

Actions136

Overview

This node interacts with the AvantGuard CIPP API to retrieve device lists filtered by a tenant identifier. It is useful in scenarios where users need to fetch and process device information associated with specific tenants within the AvantGuard system. For example, an IT administrator could use this node to automate the retrieval of all devices registered under a particular tenant for monitoring or reporting purposes.

Properties

Name Meaning
Tenantfilter A required string used as a query filter to specify the tenant whose device list should be retrieved.

Output

The node outputs JSON data containing the list of devices corresponding to the specified tenant filter. The exact structure depends on the API response but typically includes device details such as IDs, names, statuses, and other metadata. There is no indication that the node outputs binary data.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard CIPP API.
  • The base URL for the API is configured via credentials.
  • Depends on the @avantguardllc/n8n-openapi-node package and an OpenAPI specification (openapi.json) bundled with the node.

Troubleshooting

  • Common issues:

    • Missing or invalid tenant filter value will likely cause the API request to fail or return no results.
    • Incorrect or expired API credentials will result in authentication errors.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • Authentication failures usually indicate invalid API keys; verify and update credentials.
    • HTTP 400 errors may indicate malformed requests, often due to missing or incorrect tenant filter.
    • HTTP 500 errors suggest server-side issues; retry later or contact support.

Links and References

  • AvantGuard CIPP API documentation (refer to your organization's internal API docs)
  • n8n documentation on creating custom nodes and using API credentials

Discussion