| title | Create case |
|---|---|
| description | Use this API to create a new case. |
| ms.localizationpriority | medium |
| author | mahage-msft |
| ms.subservice | ediscovery |
| doc_type | apiPageType |
| ms.date | 06/10/2024 |
Namespace: microsoft.graph.ediscovery
[!INCLUDE beta-disclaimer]
[!INCLUDE ediscovery-deprecation]
Create a new case object.
Note
Starting in September 2021, this API will create a large case type. To learn more about large cases, see Use the new case format in eDiscovery. For details, see the Changes to the Microsoft 365 advanced eDiscovery create case API blog post.
[!INCLUDE national-cloud-support]
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]
POST /compliance/ediscovery/cases| Name | Description |
|---|---|
| Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
In the request body, supply a JSON representation of a case object. The following table lists properties that can be submitted with the call.
| Property | Type | Description |
|---|---|---|
| displayName | string | The name of the eDiscovery case. |
If successful, this method returns a 201 Created response code and a new microsoft.graph.ediscovery.case object in the response body.
The following example shows a request.
POST https://graph.microsoft.com/beta/compliance/ediscovery/cases
Content-type: application/json
{
"displayName": "My Case 1",
}[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
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/beta/compliance/ediscovery/$metadata#cases/$entity",
"id": "061b9a92-8926-4bd9-b41d-abf35edc7583",
"displayName": "My Case 1",
"description": "",
"createdBy": {
"user": {
"id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
"displayName": "eDiscovery admin"
}
},
"createdDateTime": "2020-02-20T22:42:28.5505500Z",
"lastModifiedBy": {
"user": {
"id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
"displayName": "eDiscovery admin"
}
},
"lastModifiedDateTime": "2020-02-20T22:42:28.5505500Z",
"status": "active",
"closedBy": null,
"closedDateTime": null,
"externalId": ""
}