Create ediscoveryCase
Article
10/27/2023
3 contributors
Feedback
In this article
Namespace: microsoft.graph.security
Create a new ediscoveryCase object.
This API is available in the following national cloud deployments .
Global service
US Government L4
US Government L5 (DOD)
China operated by 21Vianet
✅
✅
✅
❌
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 .
Permission type
Least privileged permissions
Higher privileged permissions
Delegated (work or school account)
eDiscovery.Read.All
eDiscovery.ReadWrite.All
Delegated (personal Microsoft account)
Not supported.
Not supported.
Application
Not supported.
Not supported.
HTTP request
POST /security/cases/ediscoveryCases
Request body
In the request body, supply a JSON representation of the ediscoveryCase object.
You can specify the following properties when you create an ediscoveryCase .
Property
Type
Description
displayName
String
The name of the eDiscovery case. Required.
description
String
The case description. Optional.
externalId
String
The external case number for customer reference. Optional.
Response
If successful, this method returns a 201 Created
response code and an microsoft.graph.security.ediscoveryCase object in the response body.
Examples
Request
The following example shows a request.
POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases
Content-Type: application/json
{
"displayName": "CONTOSO LITIGATION-005",
"description": "Project Bazooka",
"externalId": "324516"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models.Security;
var requestBody = new EdiscoveryCase
{
DisplayName = "CONTOSO LITIGATION-005",
Description = "Project Bazooka",
ExternalId = "324516",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Security.Cases.EdiscoveryCases.PostAsync(requestBody);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc security cases ediscovery-cases create --body '{\
"displayName": "CONTOSO LITIGATION-005",\
"description": "Project Bazooka",\
"externalId": "324516"\
}\
'
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodelssecurity "github.com/microsoftgraph/msgraph-sdk-go/models/security"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
requestBody := graphmodelssecurity.NewEdiscoveryCase()
displayName := "CONTOSO LITIGATION-005"
requestBody.SetDisplayName(&displayName)
description := "Project Bazooka"
requestBody.SetDescription(&description)
externalId := "324516"
requestBody.SetExternalId(&externalId)
ediscoveryCases, err := graphClient.Security().Cases().EdiscoveryCases().Post(context.Background(), requestBody, nil)
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.models.security.EdiscoveryCase ediscoveryCase = new com.microsoft.graph.models.security.EdiscoveryCase();
ediscoveryCase.setDisplayName("CONTOSO LITIGATION-005");
ediscoveryCase.setDescription("Project Bazooka");
ediscoveryCase.setExternalId("324516");
com.microsoft.graph.models.security.EdiscoveryCase result = graphClient.security().cases().ediscoveryCases().post(ediscoveryCase);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
const options = {
authProvider,
};
const client = Client.init(options);
const ediscoveryCase = {
displayName: 'CONTOSO LITIGATION-005',
description: 'Project Bazooka',
externalId: '324516'
};
await client.api('/security/cases/ediscoveryCases')
.post(ediscoveryCase);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\EdiscoveryCase;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new EdiscoveryCase();
$requestBody->setDisplayName('CONTOSO LITIGATION-005');
$requestBody->setDescription('Project Bazooka');
$requestBody->setExternalId('324516');
$result = $graphServiceClient->security()->cases()->ediscoveryCases()->post($requestBody)->wait();
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
Import-Module Microsoft.Graph.Security
$params = @{
displayName = "CONTOSO LITIGATION-005"
description = "Project Bazooka"
externalId = "324516"
}
New-MgSecurityCaseEdiscoveryCase -BodyParameter $params
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
from msgraph import GraphServiceClient
from msgraph.generated.models.ediscovery_case import EdiscoveryCase
graph_client = GraphServiceClient(credentials, scopes)
request_body = EdiscoveryCase(
display_name = "CONTOSO LITIGATION-005",
description = "Project Bazooka",
external_id = "324516",
)
result = await graph_client.security.cases.ediscovery_cases.post(request_body)
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
Response
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#security/cases/ediscoveryCases/$entity",
"description": "Project Bazooka",
"lastModifiedDateTime": "2022-05-22T18:36:48.0834353Z",
"status": "active",
"closedDateTime": "2022-05-22T18:36:48.083436Z",
"externalId": "324516",
"id": "22aa2acd-7554-4330-9ba9-ce20014aaae4",
"displayName": "CONTOSO LITIGATION-005",
"createdDateTime": "2022-05-22T18:36:48.0834351Z",
"lastModifiedBy": null,
"closedBy": null
}