Microsoft Entra ID Governance
Governance

View app role audit history in PIM (preview)

In brief

Documentation now describes viewing resource and personal audit history for PIM app roles, including filtering, audit details, and CSV or JSON export.

What Entra admins need to know

Administrators can investigate app role assignments, activations, and setting changes. PIM for app roles requires Microsoft Entra ID Governance licenses; resource audit also requires ownership or an eligible administrative role.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

new file mode 100644

title: View app role audit history in PIM (preview) description: Learn how to view application-level and personal app role audit history in Microsoft Entra Privileged Identity Management during preview. ms.topic: how-to ms.date: 10/29/2026 ms.custom: pim, msecd-doc-authoring-1031 ai-usage: ai-generated #Customer Intent: As an administrator or assignee, I want to view app role audit history so that I can investigate assignment changes and review my role activity.

View app role audit history in Privileged Identity Management (preview)

Microsoft Entra Privileged Identity Management (PIM) for app roles is in preview. Use resource and personal audit history to investigate app role assignment changes, activation activity, and role-setting changes.

Prerequisites

PIM for app roles (preview) requires Microsoft Entra ID Governance licenses.

To view Resource audit, you must own the target service principal or have one of the administrative roles listed in Role assignment conditions.

View resource audit history

Use Resource audit to investigate the app role activity recorded for the selected application.

  1. Sign in to the Microsoft Entra admin center.
  2. Browse to ID Governance > Privileged Identity Management > App Roles (Preview).
  3. Select the application you want to view audit history for.
  4. Expand Activity, and then select Resource audit.
  5. Use Time span, Audit type, Original requestor, and Subject type to narrow the results.
  6. Use Search by requestor, resource, primary target or subject to find relevant entries.
  7. Review the Time, Requestor, Action, Resource name, Primary target, Subject, and Status columns.
  8. Select an entry to open Audit details. Review its Action, Status, and Status Reason, together with the other available details.
  9. Select Close to return to the list. Use Refresh to reload the audit view.

Audit details includes Date, Requestor, Action, Resource, Scope, Primary target, Subject, Type, Reason, Ticket system, Ticket number, Status, Status Reason, and Correlation ID. Some fields can be empty or show a dash for a particular event.

View my audit

Use My audit to review app role activity associated with your account for the selected application.

  1. Sign in to the Microsoft Entra admin center.
  2. Browse to ID Governance > Privileged Identity Management > App Roles (Preview).
  3. Select the application you want to view audit history for.
  4. Expand Activity, and then select My audit.
  5. Set Time span to Last day, Last week, Last month, or Custom.
  6. Use Audit type to choose All, Eligible, Assigned, Activated, or Active (Assigned + Activated).
  7. Use Subject type and Search by requestor, resource, primary target or subject to narrow the results.
  8. Select an entry to inspect Audit details. Review the recorded action, status, and other available fields, and select Close when you finish.

Export audit history

The audit toolbar provides Export. The following steps describe the Export Audits dialog shown from My audit.

  1. Open My audit, and select Export.
  2. Under Select the format of file, choose CSV or JSON.
  3. Enter Name of the file.
  4. Select Start to begin the export.

Next steps

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…