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

Security → ExecMdoAlertsList

AI-generated

Overview

This node interacts with the CIPP API to retrieve Microsoft Defender for Office (MDO) alerts for a specified tenant. It supports fetching all alerts or a single page of results, with options for pagination, custom headers, query filters, and request debugging. This node is useful for security monitoring and alert management in multi-tenant environments, allowing users to programmatically access and process security alerts from MDO.

Use Case Examples

  1. Fetch all MDO alerts for a specific tenant to monitor security events.
  2. Retrieve a single page of MDO alerts with custom query filters for targeted alert analysis.

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.
Options Additional optional settings such as custom request body, headers, query filters, batching, debug mode, pagination settings, and request timeout.

Output

JSON

  • json - The JSON response from the ExecMdoAlertsList API endpoint, containing the list of MDO alerts and related data.
  • debug - Optional debug information including the actual URL, query parameters, headers, and body sent for each API request, useful for troubleshooting.

Dependencies

  • An API key credential for authenticating with the CIPP API

Troubleshooting

  • Ensure the tenantFilter parameter is correctly set to a valid tenant domain or 'AllTenants'.
  • If pagination is enabled, verify pagination parameters are correctly configured to avoid incomplete data retrieval.
  • Enable debug mode to inspect the actual API request details if unexpected results or errors occur.
  • Check API credentials and permissions to ensure access to the security alerts endpoint.

Discussion