AvantGuard - CIPP icon

AvantGuard - CIPP

AvantGuard - CIPP

Actions136

Overview

This node interacts with the AvantGuard CIPP API to retrieve activity data related to Microsoft Teams within a specified tenant. Specifically, the "Retrieve List Teams Activity" operation fetches activity logs or metrics filtered by tenant and type. This is useful for monitoring user or team activities, auditing usage patterns, or integrating Teams activity data into workflows for reporting or alerting.

Practical examples include:

  • Fetching Teams activity reports for compliance audits.
  • Monitoring user engagement or collaboration trends in Teams.
  • Integrating Teams activity data into dashboards or analytics platforms.

Properties

Name Meaning
Tenantfilter A string used to filter the data by a specific tenant identifier or name.
Type The type of Teams activity data to retrieve. Possible values depend on the API but typically specify categories like "userActivity", "teamActivity", etc.

Output

The node outputs JSON data representing the Teams activity information retrieved from the API. The structure corresponds to the response schema defined by the AvantGuard CIPP API for Teams activity, typically including details such as timestamps, activity types, user or team identifiers, and activity metrics.

If binary data were involved (not indicated here), it would represent files or media related to the activity, but this node focuses on JSON activity data.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard CIPP API.
  • Needs the base URL of the AvantGuard resource API configured in credentials.
  • Depends on the @avantguardllc/n8n-openapi-node package for building properties and handling requests.
  • The node sends HTTP requests with headers specifying JSON content.

Troubleshooting

  • Common issues:

    • Invalid or missing tenant filter may result in empty or error responses.
    • Incorrect "Type" parameter values might cause the API to reject the request.
    • Network or authentication errors if the API key or base URL is misconfigured.
  • Error messages:

    • Authentication failures usually indicate invalid or expired API credentials; verify and update them.
    • API response errors about parameters suggest checking the "Tenantfilter" and "Type" inputs for correctness.
    • Timeout or connection errors imply network issues or incorrect endpoint URLs.

Links and References

Discussion