petra_list_incidents
Lists Microsoft 365 identity-compromise incidents such as account takeovers and BEC, newest first, with filters for tenant, user, date, and live attacker status.
Instructions
List Microsoft 365 identity-compromise incidents Petra detected (account takeovers, BEC), newest first: compromised user, occurred/created time, remediation status, whether the attacker is still live, dwell time, and the phishing email that led to it. Omit tenantId to search every tenant in the organization. Petra only alerts on real compromises.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "petra_list_incidents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum incidents Petra returns (1-500, default 100). Local filters below apply after this limit. | |
| liveOnly | No | Only incidents where the attacker is still live (isLive=true). | |
| tenantId | No | Limit to one tenant. Petra tenant ID (from petra_list_tenants, or the app.petrasecurity.com/tenant/<id> URL) or the Microsoft tenant ID; Petra resolves either. | |
| startDate | No | Only incidents created on or after this ISO 8601 date or date-time (e.g. 2026-03-01). | |
| remediationStatus | No | Only incidents with this remediationStatus (e.g. REMEDIATED, REMEDIATED_PRIOR_TO_ONBOARDING). Filtered locally, case-insensitive. | |
| userPrincipalName | No | Only incidents for this user (UPN or mail, case-insensitive). Filtered locally. | |
| includePhishingEmail | No | Include the phishingEmail details block. Defaults to true; set false for a compact list. |