CIPP icon

CIPP

CIPP-API is an Azure Function App providing the logic layer for the CIPP platform. This spec is auto-generated via static analysis of both the API (PowerShell) and frontend (React/Next.js) repositories. Last generated: 2026-03-02.

Actions75

TenantAdministrationAlerts → ListAuditLogs

AI-generated

Overview

This node interacts with the Tenant Administration Alerts resource of the CIPP API, specifically to list audit logs. It is useful for retrieving audit log data for a specified tenant domain or across multiple tenants, with options to filter by date range, log ID, and relative time. The node supports pagination and can return all results or a single page, making it suitable for audit and compliance monitoring scenarios.

Use Case Examples

  1. Retrieve all audit logs for a specific tenant domain within a given date range to monitor user activities and changes.
  2. Fetch a single page of audit logs filtered by a specific log ID to investigate a particular event.

Properties

Name Meaning
Return All Whether to return all results or only a single page. When disabled, no pagination parameters are sent and only one page of results is returned.
Tenant Filter Target tenant domain or 'AllTenants' for multi-tenant operations.
End Date The end date for filtering audit logs.
Log Id The log ID to filter audit logs.
Relative Time The relative time for filtering audit logs.
Start Date The start date for filtering audit logs.
Custom Body Optional JSON to send in the request body, merged with other fields.
Custom Headers Custom HTTP headers to add to the request.
Query Filters Query-string filters to add to the request.
Batching Batching settings for grouping input items and pausing between batches.
Debug Include debug information about the API request in the output.
Pagination Settings to configure how pagination is handled for list operations.
Timeout Timeout in milliseconds to wait for server response headers before aborting the request.

Output

JSON

  • json - The audit log entries returned from the API

Dependencies

  • An API key credential for authenticating with the CIPP API

Troubleshooting

  • Ensure the tenant filter is correctly specified and the API key credential is valid.
  • Check pagination settings if not all expected results are returned.
  • Enable debug mode to see the full request details for troubleshooting.

Links

Discussion