AvantGuard - CIPP icon

AvantGuard - CIPP

AvantGuard - CIPP

Actions136

Overview

This node integrates with the AvantGuard CIPP API to retrieve user device information from a specified list. Specifically, the "Retrieve List User Devices" operation fetches devices associated with a particular user within a tenant context. This is useful in scenarios where you need to monitor or manage devices linked to users in multi-tenant environments, such as IT asset management, security audits, or user activity tracking.

Practical examples include:

  • Fetching all devices assigned to a user for compliance checks.
  • Integrating device data into workflows for automated notifications or access control.
  • Aggregating device inventories per tenant for reporting purposes.

Properties

Name Meaning
Tenantfilter A string value used to filter the data by tenant. It specifies which tenant's data to query.
Userid The identifier of the user whose devices are to be retrieved.

Output

The node outputs JSON data containing the list of user devices retrieved from the API. Each item in the output corresponds to a device associated with the specified user under the given tenant filter. The exact structure depends on the API response but typically includes device identifiers, types, statuses, and other relevant metadata.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard CIPP API.
  • The base URL for the API is configured via credentials and appended with /api.
  • The node uses standard HTTP headers for JSON content negotiation (Accept: application/json and Content-Type: application/json).

Troubleshooting

  • Missing or invalid Tenantfilter/Userid: Ensure both required properties are provided; otherwise, the API call will fail or return no data.
  • Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • API endpoint issues: Confirm the base URL in credentials is correct and accessible.
  • Empty results: If no devices are returned, check that the tenant and user IDs exist and have associated devices.

Links and References

Discussion