MC1115305 – Enhanced eDiscovery Premium APIs (archived)

Product:

eDiscovery, Microsoft Graph, Purview, Purview Communication Compliance, Purview compliance portal

Platform:

Developer, Online, US Instances, Web, World tenant

Status:

Launched

Change type:

Feature update, Admin impact

Links:

495458

Details:

Summary:
Enhanced eDiscovery Premium APIs are being upgraded from Beta to V1, introducing new parameters and export structures to improve search accuracy and streamline workflows. The rollout will be completed by late August 2025. Admins and developers using these APIs must review the updated documentation and communicate changes to relevant teams.

Details:
What and Why
To align with the updated Microsoft Purview eDiscovery (Premium) user interface, several eDiscovery APIs are being enhanced and promoted from Beta to V1. These updates introduce new parameters and export structures that improve search accuracy, provide deeper insights, and streamline workflows for compliance and legal teams. This change is based on customer feedback and aims to deliver a more consistent and powerful experience across UI and API surfaces.
Rollout Schedule
General Availability (Worldwide): Rolling out now - Early August 2025
General Availability (GCC, GCC High, DoD): Rolling out now - Late August 2025
Impact on Your Organization
Who is affected: Admins and developers using Microsoft Purview eDiscovery (Premium) APIs in automated workflows or custom integrations.
What will happen:
The following APIs will move from Beta to V1 and become generally available:
Search Estimate Statistics
Search Export Report
Search Export Result
Search Add to ReviewSet
ReviewSet Export
New parameters added to Search Estimate Statistics API:
includeRefiners
includeQueryStats
includeUnindexedStats
advancedIndexing
locationsWithoutHits
New parameters added to ReviewSet APIs:
CloudAttachmentVersion
DocumentVersion
ItemsToInclude
Additional data options: AdvancedIndexing, HTMLTranscripts
Export structure updated to align with the new Purview portal experience.
All other APIs remain unchanged.
Action Required/Recommendations
Review the updated API documentation and parameter changes. All details are found below, and these will be moved to Live documentation by July 24, 2025
Search Estimate Statistics - ediscoverySearch: estimateStatistics - Microsoft Graph beta | Microsoft Learn
Search Export Report - ediscoverySearch: exportReport - Microsoft Graph beta | Microsoft Learn
Search Export Result - ediscoverySearch: exportResult - Microsoft Graph beta | Microsoft Learn
Search Add to ReviewSet - ediscoveryReviewSet: addToReviewSet - Microsoft Graph beta | Microsoft Learn
ReviewSet Export - ediscoveryReviewSet: export - Microsoft Graph beta | Microsoft Learn
Communicate these changes to development and compliance teams.
Refer to the Export reference for eDiscovery | Microsoft Learn
Compliance Considerations
Compliance AreaExplanation
Alters how existing customer data is processedYes - New parameters such as advancedIndexing and includeUnindexedStats change how search and indexing are performed on customer data.
Modifies eDiscovery or Content SearchYes - Enhancements to search, review set, and export APIs directly affect eDiscovery workflows.
Includes admin controlYes - Admins must update API usage and workflows to incorporate new parameters.

Change Category:
XXXXXXX ... free basic plan only

Scope:
XXXXXXX ... free basic plan only

Release Phase:
General Availability

Created:
2025-07-15

updated:
2025-07-15

Task Type

XXXXXXX ... free basic plan only

Docu to Check

XXXXXXX ... free basic plan only

MS Preperations

XXXXXXX ... free basic plan only

MS Urgency

XXXXXXX ... free basic plan only

MS workload name

XXXXXXX ... free basic plan only

linked item details

XXXXXXX ... free basic plan only

summary for non-techies**

XXXXXXX ... free basic plan only

Direct effects for Operations**

API Changes Impact
The transition from Beta to V1 for eDiscovery APIs may lead to disruptions in automated workflows if not properly communicated and prepared for, potentially causing delays in compliance processes.
   - roles: Admins, Developers
   - references: https://learn.microsoft.com/en-us/purview/edisc-ref-export, https://learn.microsoft.com/graph/api/security-ediscoverysearch-estimatestatistics?view=graph-rest-beta&tabs=http

Data Processing Alterations
New parameters such as advancedIndexing and includeUnindexedStats will change how existing customer data is processed, which could lead to unexpected results in search accuracy and compliance reporting.
   - roles: Compliance Officers, Data Analysts
   - references: https://learn.microsoft.com/en-us/purview/edisc-ref-export, https://learn.microsoft.com/graph/api/security-ediscoverysearch-exportreport?view=graph-rest-beta&tabs=http

User Experience Disruption
If the changes are not communicated effectively, users relying on the eDiscovery tools may experience confusion or frustration due to altered workflows and functionalities, impacting their productivity.
   - roles: End Users, Compliance Teams
   - references: https://learn.microsoft.com/en-us/purview/edisc-ref-export, https://learn.microsoft.com/graph/api/security-ediscoveryreviewset-export?view=graph-rest-beta&tabs=http

Configutation Options**

XXXXXXX ... paid membership only

Opportunities**

Improved Search Accuracy and Insights
The new parameters introduced in the Enhanced eDiscovery Premium APIs, such as 'includeRefiners' and 'advancedIndexing', will significantly improve search accuracy and provide deeper insights into compliance data. This will enhance the ability of legal and compliance teams to perform thorough investigations and audits.
   - next-steps: Train compliance and legal teams on how to utilize the new parameters effectively. Update internal documentation to reflect these changes and ensure all teams are aware of the enhanced capabilities.
   - roles: Compliance Officers, Legal Teams, Data Analysts
   - references: https://learn.microsoft.com/en-us/purview/edisc-ref-export, https://learn.microsoft.com/graph/api/security-ediscoverysearch-estimatestatistics?view=graph-rest-beta&tabs=http

Streamlined Workflows
The updates to the export structures and APIs are designed to streamline workflows for compliance and legal teams. By simplifying the process of exporting data and integrating with existing systems, teams can save time and reduce the complexity of compliance operations.
   - next-steps: Conduct a review of current workflows to identify areas where the new APIs can be integrated. Develop a phased implementation plan to incorporate these changes into existing processes.
   - roles: IT Administrators, Compliance Officers, Legal Teams
   - references: https://learn.microsoft.com/graph/api/security-ediscoveryreviewset-export?view=graph-rest-beta&tabs=http, https://learn.microsoft.com/graph/api/security-ediscoverysearch-exportreport?view=graph-rest-beta&tabs=http

Enhanced Administrative Control
The changes require admins to update API usage and workflows, which presents an opportunity to enhance administrative control over compliance processes. This can lead to better governance and oversight of eDiscovery activities within the organization.
   - next-steps: Establish a governance framework for API usage in eDiscovery. Schedule training sessions for admins to familiarize them with the new parameters and their implications for compliance management.
   - roles: IT Administrators, Compliance Officers, Security Teams
   - references: https://learn.microsoft.com/graph/api/security-ediscoveryreviewset-addtoreviewset?view=graph-rest-beta&tabs=http, https://learn.microsoft.com/graph/api/security-ediscoverysearch-exportresult?view=graph-rest-beta&tabs=http

Potentional Risks**

XXXXXXX ... paid membership only

Data Protection**

XXXXXXX ... paid membership only

IT Security**

XXXXXXX ... paid membership only

Hypothetical Work Council Statement**

XXXXXXX ... paid membership only

DPIA Draft**

XXXXXXX ... paid membership only

explanation for non-techies**

XXXXXXX ... free basic plan only