title	ediscoveryReviewSet: export
description	Initiate an export from a reviewSet.
author	SeunginLyu
ms.localizationpriority	medium
ms.subservice	ediscovery
doc_type	apiPageType
ms.date	06/11/2024

ediscoveryReviewSet: export

Namespace: microsoft.graph.security

[!INCLUDE beta-disclaimer]

Initiate an export from a reviewSet. For more information, see Export documents from a review set in eDiscovery (Premium).

[!INCLUDE national-cloud-support]

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table] [!INCLUDE rbac-rbac-ediscovery-custodian-export-apis]

HTTP request

POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets/{ediscoveryReviewSetId}/export

Request headers

Name	Description
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type	application/json. Required.

Request body

In the request body, supply a JSON representation of the parameters.

The following table shows the parameters that can be used with this action.

Parameter	Type	Description
description	String	Description of the export.
exportOptions	microsoft.graph.security.exportOptions	Bitwise options that control the format of the export. The possible values are: `originalFiles`, `text`, `pdfReplacement`, `fileInfo`, `tags`, `unknownFutureValue`, `splitSource`, `includeFolderAndPath`, `friendlyName`, `condensePaths`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this evolvable enum: `splitSource`, `includeFolderAndPath`, `friendlyName`, `condensePaths`. The `fileInfo` member is deprecated and stopped returning data. The summary and load files are always included. If `originalFiles` isn't selected, only the `tags` member is considered.
exportStructure	microsoft.graph.security.exportFileStructure	Bitwise options that control file structure and packaging of the export. The possible values are: `none`, `directory` (deprecated), `pst`, `unknownFutureValue`, `msg`. Use the `Prefer: include-unknown-enum-members` request header to get the following members from this evolvable enum: `msg`. The `directory` member is deprecated. It remains in beta for backward compatibility. Going forward, use either `pst` or `msg`.
outputName	String	Name of the export. Required.
azureBlobContainer (deprecated)	String	When you export to your own Azure storage account, the value is the container URL. The azureBlobContainer property is deprecated and stopped returning data.
azureBlobToken (deprecated)	String	When you export to your own Azure storage account, SAS token for the container URL. The azureBlobToken property is deprecated and stopped returning data.

Response

If the export started successfully, this action returns a 202 Accepted response code. The response also contains a Location header, which contains the location of the Export operation that was created to handle the export.

Examples

Request

The following example shows a request.

HTTP

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/export
Content-Type: application/json

{
    "outputName": "Export via API",
    "description": "Export for the Contoso investigation",
    "exportOptions": "originalFiles, tags, splitSource, includeFolderAndPath, friendlyName, condensePaths",
    "exportStructure": "msg"
}