Updates from: 04/09/2021 04:03:57
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackage Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-delete.md
Title: "Delete accessPackage"
description: "Delete accessPackage." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
One of the following permissions is required to call this API. To learn more, in
```http DELETE /identityGovernance/entitlementManagement/accessPackages/{id}+ ``` ## Request headers
v1.0 Accesspackage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-get.md
Title: "Get accessPackage"
description: "Retrieve the properties and relationships of an accessPackage object." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackage List Accesspackageresourcerolescopes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-list-accesspackageresourcerolescopes.md
Title: "List accessPackageResourceRoleScopes"
description: "Retrieve a list of accesspackageresourcerolescope objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackage List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-list.md
Title: "List accessPackages"
description: "Retrieve a list of accessPackage objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackage Post Accesspackageresourcerolescopes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-post-accesspackageresourcerolescopes.md
Title: "Create accessPackageResourceRoleScope"
description: "Create a new accessPackageResourceRoleScope for adding a resource role to an access package." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-post.md
Title: "Create accessPackage"
description: "Create a new accessPackage." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-update.md
Title: "Update accessPackage"
description: "Update the properties of an accessPackage object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | EntitlementManagement.ReadWrite.All |
+|Application | Not supported. |
## HTTP request <!-- {
Content-length: 38
``` http HTTP/1.1 204 No Content Content-Type: application/json+ ``` <!--
v1.0 Accesspackageassignment List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignment-list.md
Title: "List accessPackageAssignments"
description: "Retrieve a list of accesspackageassignment objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackageassignmentpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentpolicy-delete.md
Title: "Delete accessPackageAssignmentPolicy"
description: "Delete an accessPackageAssignmentPolicy." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackageassignmentpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentpolicy-get.md
Title: "Get accessPackageAssignmentPolicy"
description: "Retrieve the properties and relationships of an accessPackageAassignmentPolicy object." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackageassignmentpolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentpolicy-list.md
Title: "List accessPackageAssignmentPolicies"
description: "Retrieve a list of accessPackageAssignmentPolicy objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackageassignmentpolicy Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentpolicy-post.md
Title: "Create accessPackageAssignmentPolicy"
description: "Use this API to create a new accessPackageAssignmentPolicy." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackageassignmentpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentpolicy-update.md
Title: "Update accessPackageAssignmentPolicy"
description: "Update the properties of an accessPackageAssignmentPolicy object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | EntitlementManagement.ReadWrite.All |
+|Application | Not supported. |
## HTTP request <!-- {
v1.0 Accesspackageassignmentrequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentrequest-get.md
Title: "Get accessPackageAssignmentRequest"
description: "Retrieve the properties and relationships of an accessPackageAssignmentRequest object." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackageassignmentrequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentrequest-list.md
Title: "List accessPackageAssignmentRequests"
description: "Retrieve a list of accessPackageAssignmentRequest objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackageassignmentrequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentrequest-post.md
Title: "Create accessPackageAssignmentRequest"
description: "Create a new accessPackageAssignmentRequest." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackageassignmentresourcerole Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentresourcerole-get.md
Title: "Get accessPackageAssignmentResourceRole"
description: "Retrieve the properties and relationships of an accessPackageAssignmentResourceRole object." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackageassignmentresourcerole List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentresourcerole-list.md
Title: "List accessPackageAssignmentResourceRoles"
description: "Retrieve a list of accessPackageAssignmentResourceRole objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackagecatalog Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-delete.md
Title: "Delete accessPackageCatalog"
description: "Delete accessPackageCatalog." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackagecatalog Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-get.md
Title: "Get accessPackageCatalog"
description: "Retrieve the properties and relationships of accesspackagecatalog object." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackagecatalog List Accesspackageresourceroles https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-list-accesspackageresourceroles.md
Title: "List accessPackageResourceRoles"
description: "Retrieve a list of accessPackageResourceRole objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackagecatalog List Accesspackageresources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-list-accesspackageresources.md
Title: "List accessPackageResources"
description: "Retrieve a list of accesspackageresource objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackagecatalog List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-list.md
Title: "List accessPackageCatalogs"
description: "Retrieve a list of accessPackageCatalog objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackagecatalog Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-post.md
Title: "Create accessPackageCatalog"
description: "Create a new accessPackageCatalog." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackagecatalog Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-update.md
Title: "Update accessPackageCatalog"
description: "Update the properties of an accessPackageCatalog object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | EntitlementManagement.ReadWrite.All |
+|Application | Not supported. |
## HTTP request <!-- {
v1.0 Accesspackageresourceenvironment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageresourceenvironment-get.md
- Title: "Get accessPackageResourceEnvironment"
-description: "Read the properties and relationships of an accessPackageResourceEnvironment object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get accessPackageResourceEnvironment
-Namespace: microsoft.graph
--
-Read the properties and relationships of an [accessPackageResourceEnvironment](../resources/accesspackageresourceenvironment.md) object.
-
-## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /identityGovernance/entitlementManagement/accessPackageResourceEnvironments/{accessPackageResourceEnvironmentId}
-```
-
-## Optional query parameters
-This method does not currently support [OData query parameters](/graph/query-parameters).
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and an [accessPackageResourceEnvironment](../resources/accesspackageresourceenvironment.md) object in the response body.
-
-## Examples
-
-### Request
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_accesspackageresourceenvironment"
-}
>
-``` http
-GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceEnvironments/{accessPackageResourceEnvironmentId}
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-----
-### Response
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.accessPackageResourceEnvironment"
-}
>
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/accessPackageResourceEnvironments/$entity",
- "id": "615f2218-678f-471f-a60a-02c2f4f80c57",
- "displayName": "https://contoso.sharepoint.com/",
- "description": "GeoLocation: , RootSiteUrl: https://contoso.sharepoint.com/, TenantAdminUrl: https://contoso-admin.sharepoint.com/",
- "originSystem": "SharePointOnline",
- "originId": "https://contoso-admin.sharepoint.com/",
- "isDefaultEnvironment": false,
- "connectionInfo": {
- "url": "https://contoso-admin.sharepoint.com/"
- }
-}
-```
-
v1.0 Accesspackageresourceenvironment List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageresourceenvironment-list.md
- Title: "List accessPackageResourceEnvironments"
-description: "Retrieve a list of accessPackageResourceEnvironment objects."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List accessPackageResourceEnvironments
-Namespace: microsoft.graph
--
-Retrieve a list of [accessPackageResourceEnvironment](../resources/accesspackageresourceenvironment.md) objects and their properties.
-
-## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported|
-|Application|Not supported|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET identityGovernance/entitlementManagement/accessPackageResourceEnvironments?$filter=originSystem eq 'SharePointOnline'
-```
-
-## Optional query parameters
-This method requires the `$filter` [OData query parameter](/graph/query-parameters). You must apply `$filter` for an **originSystem** set to (`eq`) `SharePointOnline`.
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [accessPackageResourceEnvironment](../resources/accesspackageresourceenvironment.md) objects in the response body.
-
-## Examples
-
-### Request
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "list_accesspackageresourceenvironment"
-}
>
-``` http
-GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceEnvironments?$filter=originSystem eq 'SharePointOnline'
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-----
-### Response
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.accessPackageResourceEnvironment)"
-}
>
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/accessPackageResourceEnvironments",
- "value": [
- {
- "id": "615f2218-678f-471f-a60a-02c2f4f80c57",
- "displayName": "https://contoso.sharepoint.com/",
- "description": "https://contoso.sharepoint.com/",
- "originSystem": "SharePointOnline",
- "originId": "https://contoso-admin.sharepoint.com/",
- "isDefaultEnvironment": false,
- "connectionInfo": {
- "url": "https://contoso-admin.sharepoint.com/"
- }
- }
- ]
-}
-```
-
v1.0 Accesspackageresourcerequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageresourcerequest-list.md
Title: "List accessPackageResourceRequests"
description: "Retrieve a list of accessPackageResourceRequest objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Accesspackageresourcerequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageresourcerequest-post.md
Title: "Create accessPackageResourceRequest"
description: "Create a new accessPackageResourceRequest." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | |:|:--|
-| Delegated (work or school account) | EntitlementManagement.ReadWrite.All |
+| Delegated (work or school account) | EntitlementManagement.ReadWrite.All |
| Delegated (personal Microsoft account) | Not supported. | | Application | Not supported. |
To add an Azure AD group as a resource to a catalog, set the **catalogId** to be
To remove an Azure AD app from a catalog, set the **catalogId** to be of the ID of the catalog, **requestType** to be `AdminRemove`, and the `accessPackageResource` the resource object to be removed. The resource object can be retrieved using [list accessPackageResources](accesspackagecatalog-list-accesspackageresources.md).
-To assign the geolocation environment for a multi-geolocation Sharepoint Online resource, include the **accessPackageResourceEnvironment** relationship in the `accessPackageResource` object. This can be done in two ways:
-+ Use `@odata.bind` annotation to assign the `id` of the `accessPackageResourceEnvironment` to an `accessPackageResourceEnvironment` object.
-+ Specify the `originId` parameter of the `accessPackageResourceEnvironment` in an `accessPackageResourceEnvironment` object.
- ## Response
-If successful, this method returns a `201 Created` response code and a new [accessPackageResourceRequest](../resources/accesspackageresourcerequest.md) object in the response body.
+If successful, this method returns a 200-series response code and a new [accessPackageResourceRequest](../resources/accesspackageresourcerequest.md) object in the response body.
## Examples
-### Example 1: Create an accessPackageResourceRequest
-
-#### Request
+### Request
The following is an example of the request.
Content-type: application/json
-#### Response
+### Response
The following is an example of the response.
Content-type: application/json
} ```
-### Example 2: Create an accessPackageResourceRequest for a resource and assign an accessPackageResourceEnvironment using @odata.bind
-
-#### Request
-
-The following is an example of the request. In this example, the `@odata.bind` annotation is used to assign the `id` of the `accessPackageResourceEnvironment` to an `accessPackageResourceEnvironment` object.
---
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "create_accesspackageresourcerequest_from_accesspackageresourcerequests_with_accessPackageResourceEnvironment"
-}-->
-
-```http
-POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceRequests
-Content-type: application/json
-
-{
- "catalogId": "de9315c1-272b-4905-924b-cc112ca180c7",
- "accessPackageResource": {
- "displayName": "Community Outreach",
- "description": "https://contoso.sharepoint.com/sites/CSR",
- "resourceType": "SharePoint Online Site",
- "originId": "https://contoso.sharepoint.com/sites/CSR",
- "originSystem": "SharePointOnline",
- "accessPackageResourceEnvironment@odata.bind": "accessPackageResourceEnvironments/615f2218-678f-471f-a60a-02c2f4f80c57"
- },
- "requestType": "AdminAdd"
-}
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### Response
-
-The following is an example of the response.
-
-<!-- {
- "blockType": "response",
- "truncated": false,
- "@odata.type": "microsoft.graph.accessPackageResourceRequest"
-} -->
-
-```http
-HTTP/1.1 201 Created
-Content-type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/accessPackageResourceRequests/$entity",
- "catalogId": "de9315c1-272b-4905-924b-cc112ca180c7",
- "executeImmediately": false,
- "id": "d3f800d5-0dd6-47f3-9e90-ef562c7551dc",
- "requestType": "AdminAdd",
- "requestState": "Delivered",
- "requestStatus": "Fulfilled",
- "isValidationOnly": false,
- "expirationDateTime": null,
- "justification": null
-}
-```
-
-### Example 3: Create an accessPackageResourceRequest for a resource and assign an accessPackageResourceEnvironment using originId
-
-#### Request
-
-The following is an example of the request. In this example, the parameters of an `accessPackageResourceEnvironment` are specified in an `accessPackageResourceEnvironment` object.
---
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "create_accesspackageresourcerequest_from_accesspackageresourcerequests_with_accessPackageResourceEnvironment_New"
-}-->
-
-```http
-POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceRequests
-Content-type: application/json
-
-{
- "catalogId": "de9315c1-272b-4905-924b-cc112ca180c7",
- "accessPackageResource": {
- "displayName": "Community Outreach",
- "description": "https://contoso.sharepoint.com/sites/CSR",
- "resourceType": "SharePoint Online Site",
- "originId": "https://contoso.sharepoint.com/sites/CSR",
- "originSystem": "SharePointOnline",
- "accessPackageResourceEnvironment": {
- "originId": "https://contoso-admin.sharepoint.com/"
- }
- },
- "requestType": "AdminAdd"
-}
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### Response
-
-The following is an example of the response.
-
-<!-- {
- "blockType": "response",
- "truncated": false,
- "@odata.type": "microsoft.graph.accessPackageResourceRequest"
-} -->
-
-```http
-HTTP/1.1 201 Created
-Content-type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/accessPackageResourceRequests/$entity",
- "catalogId": "de9315c1-272b-4905-924b-cc112ca180c7",
- "executeImmediately": false,
- "id": "eadf3fbb-668c-4c3a-8d84-7c8bd73dc3e4",
- "requestType": "AdminAdd",
- "requestState": "Delivered",
- "requestStatus": "Fulfilled",
- "isValidationOnly": false,
- "expirationDateTime": null,
- "justification": null
-}
-```
-- <!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 2019-02-04 14:57:30 UTC --> <!-- {
Content-type: application/json
"section": "documentation", "tocPath": "" }-->++
v1.0 Accessreview Addreviewer https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-addreviewer.md
Title: "Add accessReview reviewer"
description: "In the Azure AD access reviews feature, update an existing accessReview object to add another user as a reviewer. This operation is only permitted for an access review that is not yet completed, and only for an access review where the reviewers are explicitly specified. This operation is not permitted for an access review in which users review their own access, and not intended for an access review in which the group owners are assigned as the reviewers. " localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview Apply https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-apply.md
Title: "Apply accessReview"
description: "In the Azure AD access reviews feature, apply the decisions of a completed accessReview. The target object can be either a one-time access review, or an instance of a recurring access review. " localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-create.md
Title: "Create accessReview"
description: "In the Azure AD access reviews feature, create a new accessReview object." localization_priority: Normal doc_type: apiPageType
This is an example of creating a one-time (not recurring) access review, explici
### Request In the request body, supply a JSON representation of the [accessReview](../resources/accessreview.md) object. -
-# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "create_accessReview_from_accessReviews" }--> ```http
Content-type: application/json
} } ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response >**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
v1.0 Accessreview Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-delete.md
Title: "Delete accessReview"
description: "In the Azure AD access reviews feature, delete an accessReview object." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-get.md
Title: "Get accessReview"
description: "In the Azure AD access reviews feature, retrieve an accessReview object." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-list.md
Title: "List accessReviews"
description: "Retrieve accessReview objects for a businessFlowTemplate." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview Listdecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-listdecisions.md
Title: "List accessReview decisions"
description: "In the Azure AD access reviews feature, retrieve the decisions of an accessReview object." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview Listmydecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-listmydecisions.md
Title: "List my accessReview decisions"
description: "In the Azure AD access reviews feature, retrieve the decisions of an accessReview object for the calling user as reviewer." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview Listreviewers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-listreviewers.md
Title: "List accessReview reviewers"
description: "In the Azure AD access reviews feature, retrieve the reviewers of an accessReview object." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview Removereviewer https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-removereviewer.md
Title: "Remove accessReview reviewer"
description: "Remove an access review reviewer." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview Reset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-reset.md
Title: "Reset accessReview"
description: "In the Azure AD access reviews feature, reset the decisions of a currently active accessReview. The target object can be either a one-time access review, or an instance of a recurring access review. Previous decisions are no longer recorded, but reviewers can continue to update decisions." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview Sendreminder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-sendreminder.md
Title: "SendReminder accessReview"
description: "In the Azure AD access reviews feature, send a reminder to the reviewers of a currently active accessReview. The target object can be either a one-time access review, or an instance of a recurring access review. " localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview Stop https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-stop.md
Title: "Stop accessReview"
description: "In the Azure AD access reviews feature, stop a currently active accessReview. The target object can be either a one-time access review, or an instance of a recurring access review. (To prevent a recurring access review from starting future instances, update it to change its scheduled end date). After the access review stops, reviewers can no longer give input, and the access review decisions can be applied." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreview Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreview-update.md
Title: "Update accessReview"
description: "In the Azure AD access reviews feature, update an existing accessReview object to change one or more of its properties." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewinstance Acceptrecommendations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstance-acceptrecommendations.md
Title: "accessReviewInstance: acceptRecommendations"
description: "Allows the acceptance of recommendations on all not reviewed decisions on an access review instance` that they are the reviewer on. " localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewinstance Applydecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstance-applydecisions.md
Title: "accessReviewInstance: applyDecisions"
description: "Apply decisions on an accessReviewInstance." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewinstance Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstance-get.md
Title: "Get accessReviewInstance"
description: "Retrieve an accessReviewInstance object." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewinstance List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstance-list.md
Title: "List accessReviewInstance"
description: "Retrieve accessReviewInstance objects." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewinstance Pendingaccessreviewinstances https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstance-pendingaccessreviewinstances.md
Title: "accessReviewInstance: pendingAccessReviewInstances"
description: "Retrieve accessReviewInstance objects pending approval by calling user." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewinstance Sendreminder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstance-sendreminder.md
Title: "accessReviewInstance: sendReminder"
description: "Sends a reminder to the reviewers of a currently active accessReviewInstance." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewinstance Stop https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstance-stop.md
Title: "Stop accessReviewInstance"
description: "Stop a currently active accessReviewInstance." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewinstancedecisionitem List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstancedecisionitem-list.md
Title: "List accessReviewInstanceDecisionItem"
description: "Retrieve accessReviewInstanceDecisionItem objects." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewinstancedecisionitem Listpendingapproval https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstancedecisionitem-listpendingapproval.md
Title: "List accessReviewInstanceDecisionItem pending approval"
description: "Retrieve accessReviewInstanceDecisionItem objects pending approval by the calling user." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewinstancedecisionitem Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstancedecisionitem-update.md
Title: "Update accessReviewInstanceDecisionItem"
description: "Update an existing accessReviewInstanceDecisionItem object that calling user is the reviewer of." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewscheduledefinition Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewscheduledefinition-create.md
Title: "Create accessReviewScheduleDefinition"
description: "Create a new accessReviewScheduleDefinition object." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewscheduledefinition Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewscheduledefinition-delete.md
Title: "Delete accessReviewScheduleDefinition"
description: "Delete an accessReviewScheduleDefinition object." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewscheduledefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewscheduledefinition-get.md
Title: "Get accessReviewScheduleDefinition"
description: "Retrieve an accessReviewScheduleDefinition object." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewscheduledefinition List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewscheduledefinition-list.md
Title: "List accessReviewScheduleDefinitions"
description: "Retrieve accessReviewScheduleDefinition objects." localization_priority: Normal doc_type: apiPageType
v1.0 Accessreviewscheduledefinition Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewscheduledefinition-update.md
Title: "Update accessReviewScheduleDefinition"
description: "Update an existing accessReviewScheduleDefinition object to change one or more of its properties." localization_priority: Normal doc_type: apiPageType
v1.0 Activities List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/activities-list.md
+ Last updated 09/10/2017 Title: File Activities description: "List the recent activities that took place on an item or under a hierarchy."
GET https://graph.microsoft.com/beta/me/drive/activities
<!-- { "blockType": "response", "@type": "Collection(microsoft.graph.itemActivity)", "truncated": true } -->
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Activitybasedtimeoutpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/activitybasedtimeoutpolicy-delete.md
Title: "Delete activityBasedTimeoutPolicy"
description: "Delete activityBasedTimeoutPolicy." localization_priority: Normal doc_type: "apiPageType"
v1.0 Activitybasedtimeoutpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/activitybasedtimeoutpolicy-get.md
Title: "Get activityBasedTimeoutPolicy"
description: "Get the properties of an activityBasedTimeoutPolicy object." localization_priority: Normal doc_type: "apiPageType"
v1.0 Activitybasedtimeoutpolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/activitybasedtimeoutpolicy-list.md
Title: "List activityBasedTimeoutPolicies"
description: "Get a list of activityBasedTimeoutPolicy objects." localization_priority: Normal doc_type: "apiPageType"
v1.0 Activitybasedtimeoutpolicy Post Activitybasedtimeoutpolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/activitybasedtimeoutpolicy-post-activitybasedtimeoutpolicies.md
Title: "Create activityBasedTimeoutPolicy"
description: "Create a new activityBasedTimeoutPolicy." localization_priority: Normal doc_type: "apiPageType"
v1.0 Activitybasedtimeoutpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/activitybasedtimeoutpolicy-update.md
Title: "Update activitybasedtimeoutpolicy"
description: "Update the properties of an activityBasedTimeoutPolicy object." localization_priority: Normal doc_type: "apiPageType"
v1.0 Administrativeunit Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-delete-members.md
Title: "Remove a member"
description: "Use this API to remove a member (user or group) from an administrative unit." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit Delete Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-delete-scopedrolemembers.md
Title: "Remove a scopedRoleMember"
description: "Remove a scoped-role member from an adminstrative unit." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-delete.md
Title: "Delete administrativeUnit"
description: "Delete an administrativeUnit." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-delta.md
Title: "administrativeUnit: delta"
description: "Get newly created, updated, or deleted administrative units without having to perform a full read of the entire resource collection." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit Get Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-get-members.md
Title: "Get a member"
description: "Use this API to get a specific member (user or group) in an administrative unit." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit Get Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-get-scopedrolemembers.md
Title: "Get a scopedRoleMember"
description: "Retrieve a specific scopedRoleMembership resource." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-get.md
Title: "Get administrativeUnit"
description: "Retrieve the properties and relationships of an administrativeUnit object." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-list-members.md
Title: "List members"
description: "Use this API to get the members list (user and group) in an administrative unit." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit List Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-list-scopedrolemembers.md
Title: "List scopedRoleMembers"
description: "Retrieve a list of scopedRoleMembership resources." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-list.md
Title: "List administrativeUnits"
description: "Retrieve a list of administrativeUnit objects." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit Post Administrativeunits https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-post-administrativeunits.md
Title: "Create administrativeUnit"
description: "Use this API to create a new administrativeUnit." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-post-members.md
Title: "Add a member"
description: "Use this API to add a member (user or group) to an administrative unit." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit Post Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-post-scopedrolemembers.md
Title: "Add a scopedRoleMember"
description: "Add a new scopedRoleMembership. NOTE: Only the *User account administrator* and *Helpdesk administrator* roles are currently supported for scoped-role memberships." localization_priority: Normal doc_type: apiPageType
v1.0 Administrativeunit Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/administrativeunit-update.md
Title: "Update administrativeunit"
description: "Update the properties of an administrativeUnit object." localization_priority: Normal doc_type: apiPageType
v1.0 Agreement Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/agreement-delete.md
Title: "Delete agreement"
description: "Delete an agreement object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-DELETE /identityGovernance/termsOfUse/agreements/{id}
+DELETE /agreements/{id}
``` ## Request headers | Name | Type | Description |
If successful, this method returns a `204, No Content` response code. It does no
## Example ##### Request
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_agreement" }--> ```http
-DELETE https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements/{id}
+DELETE https://graph.microsoft.com/beta/agreements/{id}
```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++ ##### Response >**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
v1.0 Agreement Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/agreement-get.md
Title: "Get agreement"
description: "Retrieve the properties and relationships of an agreement object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /identityGovernance/termsOfUse/agreements/{id}
+GET /agreements/{id}
``` <!-- ## Optional query parameters
If successful, this method returns a `200 OK` response code and [agreement](../r
## Example ##### Request
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_agreement" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements/{id}?$expand=files
+GET https://graph.microsoft.com/beta/agreements/{id}?$expand=files
```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++ ##### Response >**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
v1.0 Agreement List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/agreement-list.md
Title: "List agreements"
description: "Retrieve a list of agreement objects." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /identityGovernance/termsOfUse/agreements
+GET /agreements
``` <!-- ## Optional query parameters
If successful, this method returns a `200 OK` response code and collection of [a
## Example ##### Request
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_agreements" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements
+GET https://graph.microsoft.com/beta/agreements
```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++ ##### Response >**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
v1.0 Agreement Post Agreements https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/agreement-post-agreements.md
Title: "Create agreement"
description: "Create a new agreement object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /identityGovernance/termsOfUse/agreements
+POST /agreements
``` ## Request headers | Name | Type | Description |
If successful, this method returns a `201, Created` response code and [agreement
In the request body, supply a JSON representation of the [agreement](../resources/agreement.md) object.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_agreement_from_agreements" }--> ```http
-POST https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements
+POST https://graph.microsoft.com/beta/agreements
Content-type: application/json {
Content-type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++ ##### Response
v1.0 Agreement Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/agreement-update.md
Title: "Update agreement"
description: "Update the properties of an agreement object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /identityGovernance/termsOfUse/agreements/{id}
+PATCH /agreements/{id}
``` ## Request headers | Name | Type | Description |
If successful, this method returns a `200 OK` response code and an updated [agre
## Example ##### Request
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_agreement" }--> ```http
-PATCH https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements/{id}
+PATCH https://graph.microsoft.com/beta/agreements/{id}
Content-type: application/json Content-length: 85
Content-length: 85
"isViewingBeforeAcceptanceRequired": true } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++ ##### Response >**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
v1.0 Anonymousipriskevent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/anonymousipriskevent-get.md
Title: "Get anonymousIpRiskEvent"
description: "Retrieve the properties and relationships of an anonymousipriskevent object." localization_priority: Normal doc_type: apiPageType
v1.0 Anonymousipriskevent List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/anonymousipriskevent-list.md
Title: "List anonymousIpRiskEvents"
description: "Retrieve a list of anonymousipriskevent objects." localization_priority: Normal doc_type: apiPageType
v1.0 Application Addkey https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-addkey.md
Title: "application: addKey"
description: "Add a key credential to an application." localization_priority: Normal doc_type: "apiPageType"
The following is an example of the response.
<!-- { "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.keyCredential"
+ "truncated": true
} --> ```http
Content-Type: application/json
"section": "documentation", "tocPath": "", "suppressions": [
- ]
+ "Error: application_addkey:\r\n Resource type was null or missing, so we assume there is no response to validate."
+ ]
}--> -
v1.0 Application Addpassword https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-addpassword.md
Title: "application: addPassword"
description: "Add a strong password to an application." localization_priority: Normal doc_type: "apiPageType"
Content-type: application/json
}--> -
v1.0 Application Delete Extensionproperty https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-delete-extensionproperty.md
Title: "Delete extensionProperty"
description: "Delete an extensionProperty." localization_priority: Normal doc_type: "apiPageType"
HTTP/1.1 204 No Content
}--> -
v1.0 Application Delete Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-delete-owners.md
Title: "Remove owner"
description: "Remove an owner from an application." localization_priority: Normal doc_type: apiPageType
HTTP/1.1 204 No Content
--> -
v1.0 Application Delete Tokenissuancepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-delete-tokenissuancepolicies.md
Title: "Remove tokenIssuancePolicy"
description: "Remove a tokenIssuancePolicy from an application." localization_priority: Normal doc_type: "apiPageType"
HTTP/1.1 204 No Content
}--> -
v1.0 Application Delete Tokenlifetimepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-delete-tokenlifetimepolicies.md
Title: "Remove tokenLifetimePolicy"
description: "Remove a tokenLifetimePolicy from an application or servicePrincipal." localization_priority: Normal doc_type: "apiPageType"
HTTP/1.1 204 No Content
}--> -
v1.0 Application Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-delete.md
Title: "Delete application"
description: "Deletes an application." localization_priority: Normal doc_type: apiPageType
HTTP/1.1 204 No Content
--> -
v1.0 Application Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-delta.md
Title: "application: delta"
description: "Get newly created, updated, or deleted applications without having to perform a full read of the entire resource collection. See Using Delta Query for details." localization_priority: Normal doc_type: apiPageType
Content-type: application/json
--> -
v1.0 Application Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-get.md
Title: "Get application"
description: "Get the properties and relationships of an application object." localization_priority: Priority doc_type: apiPageType
Content-length: 1044
--> -
v1.0 Application List Extensionproperty https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-list-extensionproperty.md
Title: "List extensionProperties"
description: "Retrieve a list of extensionproperty objects." localization_priority: Normal doc_type: "apiPageType"
Content-type: application/json
}--> -
v1.0 Application List Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-list-owners.md
Title: "List owners"
description: "Retrieve a list of owners (directoryObject objects) for an application." localization_priority: Normal doc_type: apiPageType
Content-length: 55
] } -->-
v1.0 Application List Tokenissuancepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-list-tokenissuancepolicies.md
Title: "List assigned tokenIssuancePolicies"
description: "List tokenIssuancePolicies that are assigned to an application." localization_priority: Normal doc_type: "apiPageType"
Content-type: application/json
}--> -
v1.0 Application List Tokenlifetimepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-list-tokenlifetimepolicies.md
Title: "List assigned tokenLifetimePolicies"
description: "List tokenLifetimePolicies that are assigned to an application or servicePrincipal." localization_priority: Normal doc_type: "apiPageType"
Content-type: application/json
}--> -
v1.0 Application List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-list.md
Title: "List applications"
description: "Get the list of applications in this organization." localization_priority: Priority doc_type: apiPageType
Content-type: application/json
--> -
v1.0 Application Post Applications https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-applications.md
description: "Create a new application."
localization_priority: Priority doc_type: apiPageType # Create application
Content-length: 1145
--> -
v1.0 Application Post Calls https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-calls.md
The values of authorization token, callback url, application id, application nam
##### Request -
-# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "join-meeting-service-hosted-media", "@odata.type": "microsoft.graph.call" }-->
Content-Type: application/json
"tenantId":"86dc81db-c112-4228-9222-63f3esaa1edb" } ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
--- ##### Response <!-- {
Content-Type: application/json
> **Note:** This call requires the Calls.Initiate.All permission.
-This call requires an application instance with a PSTN number assigned. For details, see [Assign a phone number to your bot](/graph/cloud-communications-phone-number#assign-a-phone-number-to-your-bot).
+This call requires an application instance with a PSTN number assigned.
+
+#### Step 1: Create application instance
+Using tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to create the application instance. For more information, see [New-CsOnlineApplicationInstance](/powershell/module/skype/new-csonlineapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <UPN> -DisplayName <DisplayName> -ApplicationId <AppId>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+#### Step 2: Assign Microsoft 365 licenses
+1. Use tenant admin credentials to sign in to https://admin.microsoft.com/ and go to the **Users -> Active users** tab.
+2. Select the application instance, assign **Microsoft 365 Domestic and International Calling Plan** and **Microsoft 365 Phone System - Virtual User** licenses, and click **Save changes**. If the required licenses are not available in the tenant, you can get them from the **Billing -> Purchase services** tab.
+#### Step 3: Acquire PSTN number
+1. Use tenant admin credentials to sign in to https://admin.teams.microsoft.com/ and click the **Legacy portal** tab on the left panel.
+2. In the new page, go to the **voice -> phone numbers** tab.
+3. Click the **+** button, select **New Service Numbers**, and go to the **Add new service numbers** page.
+4. Select **Country/Region**, **State/Region**, **City**, input **Quantity**, and click **add** to search. Click **acquire numbers**. The newly acquired number will show on the **phone numbers** tab.
+#### Step 4: Assign PSTN number to application instance
+With tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to assign the PSTN number to the application instance. For more information, see [Set-CsOnlineVoiceApplicationInstance](https://docs.microsoft.com/powershell/module/skype/set-csonlinevoiceapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](https://docs.microsoft.com/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <UPN> -TelephoneNumber <TelephoneNumber>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+> **Note:** If a tenant has Australian PSTN numbers assigned to any application instances, this call might fail. If a tenant is newly created, it might take several days for this feature to be available.
#### Request The following example shows the request to make a peer-to-peer call between the bot and a PSTN number. In this example, the media is hosted by the service. The values of authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID must be replaced with actual values to make the example work.
Content-Type: application/json
> **Note**: This example requires Calls.Initiate.All and Calls.AccessMedia.All permissions.
-This call requires an application instance with a PSTN number assigned. For details, see [Assign a phone number to your bot](/graph/cloud-communications-phone-number#assign-a-phone-number-to-your-bot).
+This call needs application instance with PSTN number assigned, as described in Example 9.
+
+> **Note:** If a tenant has Australian PSTN numbers assigned to any application instances, this call might not work. If a tenant is newly created, it might take several days for this feature to be available.
#### Request The following example shows a request to make a peer-to-peer call between the bot and a PSTN number. In this example, the media is hosted locally by the application. Replace the values for authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID to make the example work.
v1.0 Application Post Extensionproperty https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-extensionproperty.md
Title: "Create extensionProperty"
description: "Create a new extensionProperty." localization_priority: Normal doc_type: "apiPageType"
Content-type: application/json
}--> -
v1.0 Application Post Onlinemeetings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-onlinemeetings.md
Title: "Create onlineMeeting" description: "Create an online meeting on behalf of a user specified in the request body."-+ localization_priority: Priority ms.prod: "cloud-communications" doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
| :- | :- | | Delegated (work or school account) | OnlineMeetings.ReadWrite | | Delegated (personal Microsoft account) | Not supported. |
-| Application | OnlineMeetings.ReadWrite.All* |
+| Application | OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All* |
> [!IMPORTANT] > \* Administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user, authorizing the app configured in the policy to create an online meeting on behalf of that user (user ID specified in the request path).
Content-Type: application/json
"creationDateTime": "2019-07-11T02:17:17.6491364Z", "startDateTime": "2019-07-11T02:17:17.6491364Z", "endDateTime": "2019-07-11T02:47:17.651138Z",
- "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy",
+ "id": "550fae72-d251-43ec-868c-373732c2704f_19:meeting_M2IzYzczNTItYmY3OC00MDlmLWJjMzUtYmFiMjNlOTY4MGEz@thread.skype",
"joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_M2IzYzczNTItYmY3OC00MDlmLWJjMzUtYmFiMjNlOTY4MGEz%40thread.skype/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%22550fae72-d251-43ec-868c-373732c2704f%22%7d", "participants": { "organizer": {
Content-Type: application/json
"creationDateTime": "2019-07-11T02:17:17.6491364Z", "startDateTime": "2019-07-11T02:17:17.6491364Z", "endDateTime": "2019-07-11T02:47:17.651138Z",
- "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy",
+ "id": "550fae72-d251-43ec-868c-373732c2704f_19%3A3b52398f3c524556894b776357c1dd79%40thread.skype",
"joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_M2IzYzczNTItYmY3OC00MDlmLWJjMzUtYmFiMjNlOTY4MGEz%40thread.skype/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%22550fae72-d251-43ec-868c-373732c2704f%22%7d", "participants": { "organizer": {
v1.0 Application Post Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-owners.md
Title: "Add owner"
description: "Use this API to add an owner to an application." localization_priority: Normal doc_type: apiPageType
HTTP/1.1 204 No Content
--> -
v1.0 Application Post Tokenissuancepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-tokenissuancepolicies.md
Title: "Assign tokenIssuancePolicy"
description: "Assign a tokenIssuancePolicy to an application." localization_priority: Normal doc_type: "apiPageType"
HTTP/1.1 204 No Content
}--> -
v1.0 Application Post Tokenlifetimepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-tokenlifetimepolicies.md
Title: "Assign tokenLifetimePolicy"
description: "Assign a tokenLifetimePolicy to an application or service principal." localization_priority: Normal doc_type: "apiPageType"
HTTP/1.1 204 No Content
}--> -
v1.0 Application Removekey https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-removekey.md
Title: "application: removeKey"
description: "Remove a key credential from an application" localization_priority: Normal doc_type: "apiPageType"
HTTP/1.1 204 No Content
}--> -
v1.0 Application Removepassword https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-removepassword.md
Title: "application: removePassword"
description: "Remove a password from an application" localization_priority: Normal doc_type: "apiPageType"
HTTP/1.1 204 No Content
}--> -
v1.0 Application Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-update.md
Title: "Update application"
description: "Update the properties of an application object." localization_priority: Normal doc_type: apiPageType
HTTP/1.1 204 No Content
--> -
v1.0 Applicationsignindetailedsummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/applicationsignindetailedsummary-get.md
Title: "Get applicationSignInDetailedSummary"
description: "Retrieve the properties and relationships of an applicationSignInDetailSummary object." localization_priority: Normal doc_type: apiPageType
v1.0 Applicationsigninsummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/applicationsigninsummary-get.md
Title: "Get applicationSignInSummary"
description: "Retrieve the properties and relationships of an **applicationSigninSummary** object." localization_priority: Normal doc_type: apiPageType
v1.0 Applicationtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/applicationtemplate-get.md
Title: "Get applicationTemplate"
description: "Retrieve the properties and relationships of applicationtemplate object." localization_priority: Normal doc_type: "apiPageType"
GET https://graph.microsoft.com/beta/applicationTemplates/{id}
The following is an example of the response.
-> **Note:** The response object shown here might be shortened for readability.
+> [!NOTE]
+> The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
<!-- { "blockType": "response",
Content-type: application/json
}--> -
v1.0 Applicationtemplate Instantiate https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/applicationtemplate-instantiate.md
Title: "applicationTemplate: instantiate"
description: "Use this API to create a new applicationTemplate" localization_priority: Normal doc_type: "apiPageType"
The following example shows how to call this API.
### Request The following is an example of the request.
-
+
+> [!NOTE]
> You can use this API to instantiate [non-gallery apps](/azure/active-directory/manage-apps/add-non-gallery-app). Use the following ID for **applicationTemplate**: `8adf8e6e-67b2-4cf2-a259-e3dc5476c621`. # [HTTP](#tab/http)
Content-type: application/json
The following is an example of the response.
-> **Note:** The response object shown here might be shortened for readability.
+> [!NOTE]
+> The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
<!-- { "blockType": "response",
Content-type: application/json
"section": "documentation", "tocPath": "" }-->-
v1.0 Applicationtemplate List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/applicationtemplate-list.md
Title: "List applicationTemplates"
description: "Retrieve a list of applicationtemplate objects." localization_priority: Normal doc_type: "apiPageType"
GET https://graph.microsoft.com/beta/applicationTemplates
The following is an example of the response.
-> **Note:** The response object shown here might be shortened for readability.
+> [!NOTE]
+> The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
<!-- { "blockType": "response",
Content-type: application/json
}--> -
v1.0 Attachment Createuploadsession https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/attachment-createuploadsession.md
Title: "attachment: createUploadSession" description: "Create an upload session to iteratively upload ranges of a file so as to attach the file to the specified message." localization_priority: Normal-+ ms.prod: "outlook" doc_type: "apiPageType"
v1.0 Attachment Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/attachment-delete.md
description: "Delete an attachment from a calendar event, message, Outlook task,
localization_priority: Normal doc_type: apiPageType ms.prod: "outlook"-+ # Delete attachment
Delete an attachment from a user calendar [event](../resources/event.md), [messa
## Permissions
-Depending on the resource (**event**, **message**, **outlookTask**, or **post**) that the attachment is attached to and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
-
-| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application |
-|:--|:--|:--|:--|
-| [event](../resources/event.md) | Calendars.ReadWrite | Calendars.ReadWrite | Calendars.ReadWrite |
-| [message](../resources/message.md) | Mail.ReadWrite | Mail.ReadWrite | Mail.ReadWrite |
-| [outlookTask](../resources/outlooktask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
-| [post](../resources/post.md) | Group.ReadWrite.All | Not supported | Not supported |
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+* If accessing attachments in messages: Mail.ReadWrite
+* If accessing attachments in events: Calendars.ReadWrite
+* If accessing attachments in Outlook tasks: Tasks.ReadWrite
+* If accessing attachments in group posts: Group.ReadWrite.All
<!-- * If accessing attachments in Group Events or Posts: Group.ReadWrite.All
Attachments for an [event](../resources/event.md) in a [calendar](../resources/c
```http DELETE /me/calendars/{id}/events/{id}/attachments/{id} DELETE /users/{id | userPrincipalName}/calendars/{id}/events/{id}/attachments/{id}+
+DELETE /me/calendargroup/calendars/{id}/events/{id}/attachments/{id}
+DELETE /users/{id | userPrincipalName}/calendargroup/calendars/{id}/events/{id}/attachments/{id}
``` Attachments for an [event](../resources/event.md) in a [calendar](../resources/calendar.md) belonging to a user's [calendarGroup](../resources/calendargroup.md). <!-- { "blockType": "ignored" } -->
v1.0 Attachment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/attachment-get.md
Title: "Get attachment"
description: "Read the properties and relationships of an attachment, attached to an event, message, Outlook task, or post." localization_priority: Normal doc_type: apiPageType-+ ms.prod: "outlook"
Namespace: microsoft.graph
[!INCLUDE [outlooktask-deprecate-sharedfeature](../../includes/outlooktask-deprecate-sharedfeature.md)]
-Read the properties, relationships, or raw contents of an attachment that is attached to a user [event](../resources/event.md), [message](../resources/message.md), [Outlook task](../resources/outlooktask.md), or group [post](../resources/post.md).
+Read the properties, relationships, or raw contents of an attachment, attached to a user [event](../resources/event.md), [message](../resources/message.md), [Outlook task](../resources/outlooktask.md), or [post](../resources/post.md).
An attachment can be one of the following types:
-* A file. Programmatically, this is a [fileAttachment](../resources/fileattachment.md) resource. See [example 1](#example-1-get-the-properties-of-a-file-attachment).
-* An Outlook item (contact, event or message). Programmatically, an item attachment is an [itemAttachment](../resources/itemattachment.md) resource. You can use `$expand` to further get the properties of that item, including any nested attachments up to 30 levels. See [example 3](#example-3-expand-and-get-the-properties-of-the-item-attached-to-a-message) and [example 4](#example-4-expand-and-get-the-properties-of-an-item-attached-to-a-message-including-any-attachment-to-the-item).
-* A link to a file stored in the cloud. Programmatically, this is a [referenceAttachment](../resources/referenceattachment.md) resource. See [example 5](#example-5-get-the-properties-of-a-reference-attachment).
+* A file ([fileAttachment](../resources/fileattachment.md) resource).
+* An item (contact, event or message, represented by an [itemAttachment](../resources/itemattachment.md) resource). You can use `$expand` to further get the properties of that item. See an [example](#example-3-expand-and-get-the-properties-of-the-item-attached-to-a-message).
+* A link to a file ([referenceAttachment](../resources/referenceattachment.md) resource).
-All these types of attachments are derived from the [attachment](../resources/attachment.md) resource.
+All these types of attachment resources are derived from the [attachment](../resources/attachment.md)
+resource.
### Get the raw contents of a file or item attachment You can append the path segment `/$value` to get the raw contents of a file or item attachment.
-For a file attachment, the content type is based on its original content type. See an [example 6](#example-6-get-the-raw-contents-of-a-file-attachment-on-a-message).
+For a file attachment, the content type is based on its original content type. See an [example](#example-5-get-the-raw-contents-of-a-file-attachment-on-a-message) below.
For an item attachment that is a [contact](../resources/contact.md), [event](../resources/event.md), or [message](../resources/message.md), the raw contents returned is in MIME format. | Item attachment type | Raw contents returned | |:--|:-|
-| **contact** | [vCard](http://www.faqs.org/rfcs/rfc2426.html) MIME format. See [example 7](#example-7-get-the-mime-raw-contents-of-a-contact-attachment-on-a-message). |
-| **event** | iCal MIME format. See [example 8](#example-8-get-the-mime-raw-contents-of-an-event-attachment-on-a-message). |
-| **message** | MIME format. See [example 9](#example-9-get-the-mime-raw-contents-of-a-meeting-invitation-item-attachment-on-a-message). |
+| **contact** | [vCard](http://www.faqs.org/rfcs/rfc2426.html) MIME format. See [example](#example-6-get-the-mime-raw-contents-of-a-contact-attachment-on-a-message). |
+| **event** | iCal MIME format. See [example](#example-7-get-the-mime-raw-contents-of-an-event-attachment-on-a-message). |
+| **message** | MIME format. See [example](#example-8-get-the-mime-raw-contents-of-a-meeting-invitation-item-attachment-on-a-message). |
Attempting to get the `$value` of a reference attachment returns HTTP 405. ## Permissions
-Depending on the resource (**event**, **message**, **outlookTask**, or **post**) that the attachment is attached to and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
-
-| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application |
-|:--|:--|:--|:--|
-| [event](../resources/event.md) | Calendars.Read | Calendars.Read | Calendars.Read |
-| [message](../resources/message.md) | Mail.Read | Mail.Read | Mail.Read |
-| [outlookTask](../resources/outlooktask.md) | Tasks.Read | Tasks.Read | Not supported |
-| [post](../resources/post.md) | Group.Read.All | Not supported | Not supported |
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+* If accessing attachments in messages: Mail.Read
+* If accessing attachments in events: Calendars.Read
+* If accessing attachments in Outlook tasks: Tasks.Read
+* If accessing attachments in group posts: Group.Read.All
<!-- * If accessing attachments in group events or posts: Group.Read.All
GET /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/attachments/{id}/$va
## Optional query parameters
-This method supports some of the [OData Query Parameters](/graph/query-parameters) to help customize the response.
-
-Use `$expand` to get the properties of an item attachment (contact, event, or message). See [example 3](#example-3-expand-and-get-the-properties-of-the-item-attached-to-a-message) and [example 4](#example-4-expand-and-get-the-properties-of-an-item-attached-to-a-message-including-any-attachment-to-the-item).
+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
## Request headers
Content-type: application/json
"hasAttachments":false, "internetMessageId":"<BY2PR15MB05189A084C01F466709E414F9CA40@BY2PR15MB0518.namprd15.prod.outlook.com>", "subject":"Reminder - please bring laptop",
- "bodyPreview": "PFA\r\n\r\nThanks,\r\nRob",
"importance":"normal", "conversationId":"AAQkADA1MzMyOGI4LTlkZDctNDkzYy05M2RiLTdiN2E1NDE3MTRkOQAQAMG_NSCMBqdKrLa2EmR-lO0=", "conversationIndex":"AQHTAbcSwb41IIwGp0qstrYSZH+U7Q==",
Content-type: application/json
"isRead":false, "isDraft":false, "webLink":"https://outlook.office365.com/owa/?ItemID=AAMkADA1M3MTRkOQAAAA%3D%3D&exvsurl=1&viewmodel=ReadMessageItem",
- "internetMessageHeaders": [ ],
"body":{ "contentType":"html", "content":"<html><head>\r\n</head>\r\n<body>\r\n</body>\r\n</html>"
Content-type: application/json
} ```
-### Example 4: Expand and get the properties of an item attached to a message, including any attachment to the item
-#### Request
-The next example uses the same request as in [example 3](#example-3-expand-and-get-the-properties-of-the-item-attached-to-a-message) to get the properties of an item attachment on a message by using `$expand`. In this case, because the attached item also has a file attachment, the response includes the properties of the file attachment as well.
-
-<!-- {
- "blockType": "request",
- "name": "get_and_expand_nested_item_attachment",
- "sampleKeys": ["AAMkADA1M-zAAA=","AAMkADA1M-CJKtzmnlcqVgqI="]
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/me/messages('AAMkADA1M-zAAA=')/attachments('AAMkADA1M-CJKtzmnlcqVgqI=')/?$expand=microsoft.graph.itemattachment/item
-```
-
-#### Response
-<!-- {
- "blockType": "response",
- "name": "get_and_expand_nested_item_attachment",
- "truncated": true,
- "@odata.type": "microsoft.graph.itemAttachment"
-} -->
-
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('d1a2fae9-db66-4cc9-8133-2184c77af1b8')/messages('AAMkADA1M-zAAA%3D')/attachments(microsoft.graph.itemAttachment/item())/$entity",
- "@odata.type": "#microsoft.graph.itemAttachment",
- "id": "AAMkADA1MCJKtzmnlcqVgqI=",
- "lastModifiedDateTime": "2021-01-06T13:28:11Z",
- "name": "Nested Message With Attachment",
- "contentType": null,
- "size": 465916,
- "isInline": false,
- "item@odata.context": "https://graph.microsoft.com/beta/$metadata#users('d1a2fae9-db66-4cc9-8133-2184c77af1b8')/messages('AAMkADA1M-zAAA%3D')/attachments('AAMkADA1M-CJKtzmnlcqVgqI%3D')/microsoft.graph.itemAttachment/item/$entity",
- "item": {
- "@odata.type": "#microsoft.graph.message",
- "id": "",
- "createdDateTime": "2021-01-06T13:28:30Z",
- "lastModifiedDateTime": "2021-01-06T13:27:40Z",
- "receivedDateTime": "2021-01-06T13:27:25Z",
- "sentDateTime": "2021-01-06T13:27:04Z",
- "hasAttachments": true,
- "internetMessageId": "<BY2PR15MB05189A084C01F466709E414F9CA40@BY2PR15MB0518.namprd15.prod.outlook.com>",
- "subject": "Nested Message With Attachment",
- "bodyPreview": "PFAThanks,Adele",
- "importance": "normal",
- "conversationId": "AAQkADg3NTY5MDg4LWMzYmQtNDQzNi05OTgwLWQyZjg2YWQwMTNkZAAQAO6hkp84oMdGm6ZBsSH72sE=",
- "conversationIndex": "AQHW5C+U7qGSnzigx0abpkGxIfvawQ==",
- "isDeliveryReceiptRequested": false,
- "isReadReceiptRequested": false,
- "isRead": true,
- "isDraft": false,
- "webLink": "https://outlook.office365.com/owa/?ItemID=AAMkADA1M3MTRkOQAAAA%3D%3D&exvsurl=1&viewmodel=ItemAttachment",
- "internetMessageHeaders": [],
- "body": {
- "contentType": "html",
- "content": "<html><head>\r\n</head>\r\n<body>\r\n</body>\r\n</html>"
- },
- "sender": {
- "emailAddress": {
- "name": "Adele Vance",
- "address": "Adele.Vance@microsoft.com"
- }
- },
- "from": {
- "emailAddress": {
- "name": "Adele Vance",
- "address": "Adele.Vance@microsoft.com"
- }
- },
- "toRecipients": [
- {
- "emailAddress": {
- "name": "Adele Vance",
- "address": "Adele.Vance@microsoft.com"
- }
- }
- ],
- "flag": {
- "flagStatus": "notFlagged"
- },
- "attachments@odata.context": "https://graph.microsoft.com/beta/$metadata#users('d1a2fae9-db66-4cc9-8133-2184c77af1b8')/messages('AAMkADA1M-zAAA%3D')/attachments('AAMkADA1M-CJKtzmnlcqVgqI%3D')/microsoft.graph.itemAttachment/microsoft.graph.itemAttachment/item/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/attachments",
- "attachments": [
- {
- "@odata.type": "#microsoft.graph.fileAttachment",
- "@odata.mediaContentType": "application/pdf",
- "id": "AAMkADg3NTYULmbsDYNg==",
- "lastModifiedDateTime": "2021-01-21T14:56:18Z",
- "name": "Info.pdf",
- "contentType": "application/pdf",
- "size": 417351,
- "isInline": false,
- "contentId": null,
- "contentLocation": null,
- "contentBytes": "JVBERi0xLjUNCiW1tbW1DQoxIDAgb2JqDQo8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFIvTGFuZyhlbi1JTikgL1N0cnVjdFRyZWVSb29"
- }
- ]
- }
-}
-```
-
-### Example 5: Get the properties of a reference attachment
+### Example 4: Get the properties of a reference attachment
#### Request
Content-type: application/json
```
-### Example 6: Get the raw contents of a file attachment on a message
+### Example 5: Get the raw contents of a file attachment on a message
#### Request
HTTP/1.1 200 OK
```
-### Example 7: Get the MIME raw contents of a contact attachment on a message
+### Example 6: Get the MIME raw contents of a contact attachment on a message
#### Request
END:VCARD
```
-### Example 8: Get the MIME raw contents of an event attachment on a message
+### Example 7: Get the MIME raw contents of an event attachment on a message
#### Request
END:VCALENDAR
```
-### Example 9: Get the MIME raw contents of a meeting invitation item attachment on a message
+### Example 8: Get the MIME raw contents of a meeting invitation item attachment on a message
#### Request
v1.0 Authentication List Methods https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authentication-list-methods.md
One of the following permissions is required to call this API. To learn more, in
### Permissions acting on other users |Permission type | Permissions (from least to most privileged) |
-|:|:-|
+|:|:-|:--|
| Delegated (work or school account) | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. | | Application | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
v1.0 Authentication List Passwordmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authentication-list-passwordmethods.md
Title: "List passwordMethods"
description: "Retrieve a list of passwordauthenticationmethod objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
### Permissions acting on other users |Permission type | Permissions (from least to most privileged) |
-|:|:-|
+|:|:-|:--|
| Delegated (work or school account) | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. | | Application | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
v1.0 Authentication List Phonemethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authentication-list-phonemethods.md
Title: "List phoneMethods"
description: "Retrieve a list of phone authentication method objects." localization_priority: Normal doc_type: "apiPageType"
v1.0 Authentication Post Phonemethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authentication-post-phonemethods.md
Title: "Create phoneAuthenticationMethod"
description: "Add a new phone authentication method." localization_priority: Normal doc_type: "apiPageType"
v1.0 Authenticationeventspolicy List Onsignupstart https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationeventspolicy-list-onsignupstart.md
Title: "List onSignUpStart listeners"
description: "Get the collection of authenticationListener resources supported by the onSignupStart event." localization_priority: Normal doc_type: apiPageType
v1.0 Authenticationeventspolicy Post Onsignupstart https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationeventspolicy-post-onsignupstart.md
Title: "Create authenticationListener"
description: "Create a new authenticationListener object for the onSignUpStart event." localization_priority: Normal doc_type: apiPageType
v1.0 Authenticationflowspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationflowspolicy-get.md
Title: "Get authenticationFlowsPolicy"
description: "Read the properties and relationships of an authenticationFlowsPolicy object." localization_priority: Priority doc_type: apiPageType
v1.0 Authenticationflowspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationflowspolicy-update.md
Title: "Update authenticationFlowsPolicy"
description: "Update the Boolean selfServiceSignUp property of an authenticationFlowsPolicy object." localization_priority: Priority doc_type: apiPageType
v1.0 Authenticationlistener Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationlistener-delete.md
Title: "Delete authenticationListener"
description: "Deletes an authenticationListener from an event supported by an authenticationEventsPolicy." localization_priority: Normal doc_type: apiPageType
v1.0 Authenticationlistener Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationlistener-get.md
Title: "Get authenticationListener"
description: "Read the properties and relationships of an authenticationListener object." localization_priority: Normal doc_type: apiPageType
v1.0 Authenticationlistener Put https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationlistener-put.md
Title: "Put authenticationListener"
description: "Replace an authenticationListener object." localization_priority: Normal doc_type: apiPageType
v1.0 Authenticationlistener Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationlistener-update.md
Title: "Update authenticationListener"
description: "Update the listener defined for an event in the authentication pipeline." localization_priority: Normal doc_type: apiPageType
v1.0 Authenticationmethodsroot Usersregisteredbyfeature https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationmethodsroot-usersregisteredbyfeature.md
Title: "authenticationMethodsRoot: usersRegisteredByFeature"
description: "Get the number of users capable of multi-factor authentication, self-service password reset, and passwordless authentication." localization_priority: Normal doc_type: apiPageType
If successful, this function returns a `200 OK` response code and a [userRegistr
## Examples ### Request-
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "authenticationmethodsroot_usersregisteredbyfeature"
If successful, this function returns a `200 OK` response code and a [userRegistr
``` http GET https://graph.microsoft.com/beta/reports/authenticationMethods/usersRegisteredByFeature(includedUserTypes='all',includedUserRoles='all') ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response
Content-Type: application/json
} ] }
-```
+```
v1.0 Authenticationmethodsroot Usersregisteredbymethod https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationmethodsroot-usersregisteredbymethod.md
Title: "authenticationMethodsRoot: usersRegisteredByMethod"
description: "Get the number of users registered for each authentication method." localization_priority: Normal doc_type: apiPageType
If successful, this function returns a `200 OK` response code and a [userRegistr
## Examples ### Request-
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "authenticationmethodsroot_usersregisteredbymethod"
If successful, this function returns a `200 OK` response code and a [userRegistr
``` http GET https://graph.microsoft.com/beta/reports/authenticationMethods/usersRegisteredByMethod(includedUserTypes='all',includedUserRoles='all') ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response
v1.0 Authenticationoperation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationoperation-get.md
Title: "Get authentication operation"
description: "Retrieve the properties and relationships of an operation object." localization_priority: Normal doc_type: "apiPageType"
v1.0 Authorizationpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authorizationpolicy-get.md
Title: "Get authorizationPolicy"
description: "Retrieve the properties and relationships of authorizationPolicy object." localization_priority: Normal doc_type: apiPageType
v1.0 Authorizationpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authorizationpolicy-update.md
Title: "Update authorizationpolicy"
description: "Update the properties of authorizationPolicy object." localization_priority: Normal doc_type: "apiPageType"
v1.0 B2cauthenticationmethodspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cauthenticationmethodspolicy-get.md
Title: "Get b2cAuthenticationMethodsPolicy"
description: "Read the properties of a b2cAuthenticationMethodsPolicy object." localization_priority: Priority doc_type: "apiPageType"
v1.0 B2cauthenticationmethodspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cauthenticationmethodspolicy-update.md
Title: "Update b2cAuthenticationMethodsPolicy"
description: "Update properties of a b2cAuthenticationMethodsPolicy object." localization_priority: Priority doc_type: "apiPageType"
v1.0 B2cidentityuserflow Delete Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-delete-identityproviders.md
description: "Delete an identityProvider from a b2cIdentityUserFlow."
localization_priority: Normal doc_type: apiPageType # Delete an identityProvider from a b2cIdentityUserFlow
The work or school account needs to belong to one of the following roles:
<!-- { "blockType": "ignored" } --> ```http
-DELETE /identity/b2cUserFlows/{id}/identityProviders/{id}/$ref
+DELETE /b2cUserFlows/{id}/identityProviders/{id}/$ref
``` ## Request headers
v1.0 B2cidentityuserflow Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-delete.md
description: "Delete a b2cIdentityUserFlow object."
localization_priority: Normal doc_type: apiPageType # Delete b2cIdentityUserFlow
v1.0 B2cidentityuserflow Get Apiconnectorconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-get-apiconnectorconfiguration.md
Title: "Get userFlowApiConnectorConfiguration"
description: "Get the userFlowApiConnectorConfiguration property of a b2cIdentityUserFlow." localization_priority: Normal doc_type: apiPageType
v1.0 B2cidentityuserflow Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-get.md
description: "Retrieve the properties and relationships a b2cIdentityUserFlow ob
localization_priority: Normal doc_type: apiPageType # Get b2cIdentityUserFlow
v1.0 B2cidentityuserflow List Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-list-identityproviders.md
description: "List all identityProviders in a b2cIdentityUserFlow."
localization_priority: Normal doc_type: apiPageType # List all identityProviders in a b2cIdentityUserFlow
The work or school account needs to belong to one of the following roles:
<!-- { "blockType": "ignored" } --> ```http
-GET /identity/b2cUserFlows/{id}/identityProviders
+GET /b2cUserFlows/{id}/identityProviders
``` ## Request headers
v1.0 B2cidentityuserflow List Languages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-list-languages.md
Title: "List languages"
description: "Retrieve a list of languages supported for customization within a B2C user flow." localization_priority: Normal doc_type: apiPageType
v1.0 B2cidentityuserflow List Userattributeassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-list-userattributeassignments.md
Title: "List userAttributeAssignments"
description: "Get the identityUserFlowAttributeAssignment resources from the userAttributeAssignments navigation property in a b2cIdentityUserFlow." localization_priority: Normal doc_type: apiPageType
v1.0 B2cidentityuserflow Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-post-identityproviders.md
description: "Add identityProvider to a b2cIdentityUserFlow."
localization_priority: Normal doc_type: apiPageType # Add identityProvider to a b2cIdentityUserFlow
The work or school account needs to belong to one of the following roles:
<!-- { "blockType": "ignored" } --> ```http
-PATCH /identity/b2cUserFlows/{id}/identityProviders/$ref
+PATCH /b2cUserFlows/{id}/identityProviders/$ref
``` ## Request headers
v1.0 B2cidentityuserflow Post Userattributeassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-post-userattributeassignments.md
Title: "Create userAttributeAssignments"
description: "Create a new identityUserFlowAttributeAssignment object." localization_priority: Normal doc_type: apiPageType
v1.0 B2cidentityuserflow Put Apiconnectorconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-put-apiconnectorconfiguration.md
Title: "Configure an API connector in a user flow"
description: "Enable or disable an API connector to a specific step in a user flow by updating the apiConnectorConfiguration property." localization_priority: Normal doc_type: apiPageType
v1.0 B2cidentityuserflow Put Languages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-put-languages.md
Title: "Create languages"
description: "Create a custom language in an Azure AD B2C user flow." localization_priority: Normal doc_type: apiPageType
v1.0 B2cidentityuserflow Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-update.md
Title: "Update b2cIdentityUserFlow"
description: "Update the properties of a b2cIdentityUserFlow object." localization_priority: Normal doc_type: apiPageType
HTTP/1.1 204 No Content
"section": "documentation", "tocPath": "", "suppressions": [
+ "Error: update_b2cidentityuserflow/userFlowTypeVersion:\r\n Expected type Single but actual was Int64. Property: userFlowTypeVersion, actual value: '1'",
+ "Error: update_b2cidentityuserflow/userFlowTypeVersion:\r\n Expected type Single but actual was Int64. Property: userFlowTypeVersion, actual value: '1'"
] }-->
v1.0 B2xidentityuserflow Delete Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-delete-identityproviders.md
description: "Delete an identityProvider from a b2xIdentityUserFlow."
localization_priority: Normal doc_type: apiPageType # Delete identityProvider from b2xIdentityUserFlow
The work or school account needs to belong to one of the following roles:
<!-- { "blockType": "ignored" } --> ```http
-DELETE /identity/b2xUserFlows/{id}/identityProviders/{id}/$ref
+DELETE /b2xUserFlows/{id}/identityProviders/{id}/$ref
``` ## Request headers
v1.0 B2xidentityuserflow Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-delete.md
description: "Delete a b2xIdentityUserFlow object."
localization_priority: Normal doc_type: apiPageType # Delete b2xIdentityUserFlow
v1.0 B2xidentityuserflow Get Apiconnectorconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-get-apiconnectorconfiguration.md
Title: "Get userFlowApiConnectorConfiguration"
description: "Get the userFlowApiConnectorConfiguration property of a b2xIdentityUserFlow." localization_priority: Normal doc_type: apiPageType
v1.0 B2xidentityuserflow Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-get.md
description: "Retrieve the properties and relationships a b2xIdentityUserFlow ob
localization_priority: Normal doc_type: apiPageType # Get b2xIdentityUserFlow
v1.0 B2xidentityuserflow List Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-list-identityproviders.md
description: "List all identityProviders in a b2xIdentityUserFlow."
localization_priority: Normal doc_type: apiPageType # List all identityProviders in a b2xIdentityUserFlow
The work or school account needs to belong to one of the following roles:
<!-- { "blockType": "ignored" } --> ```http
-GET /identity/b2xUserFlows/{id}/identityProviders
+GET /b2xUserFlows/{id}/identityProviders
``` ## Request headers
v1.0 B2xidentityuserflow List Languages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-list-languages.md
Title: "List languages"
description: "Retrieve a list of languages supported for customization within a B2X user flow." localization_priority: Normal doc_type: apiPageType
v1.0 B2xidentityuserflow List Userattributeassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-list-userattributeassignments.md
Title: "List userAttributeAssignments"
description: "Get the identityUserFlowAttributeAssignment resources from the userAttributeAssignments navigation property." localization_priority: Normal doc_type: apiPageType
v1.0 B2xidentityuserflow Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-post-identityproviders.md
description: "Add identityProvider in a b2xIdentityUserFlow."
localization_priority: Normal doc_type: apiPageType # Add identityProvider to a b2xIdentityUserFlow
The work or school account needs to belong to one of the following roles:
<!-- { "blockType": "ignored" } --> ```http
-PATCH /identity/b2xUserFlows/{id}/identityProviders/$ref
+PATCH /b2xUserFlows/{id}/identityProviders/$ref
``` ## Request headers
v1.0 B2xidentityuserflow Post Userattributeassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-post-userattributeassignments.md
Title: "Create userAttributeAssignments"
description: "Create a new identityUserFlowAttributeAssignment object in a b2xIdentityUserFlow." localization_priority: Normal doc_type: apiPageType
v1.0 B2xidentityuserflow Put Apiconnectorconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-put-apiconnectorconfiguration.md
Title: "Configure an API connector in a user flow"
description: "Enable or disable an API connector to a specific step in a user flow by updating the apiConnectorConfiguration property." localization_priority: Normal doc_type: apiPageType
v1.0 Bitlocker List Recoverykeys https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bitlocker-list-recoverykeys.md
Title: "List recoveryKeys"
description: "Get a list of the bitlockerRecoveryKey objects and their properties." localization_priority: Normal doc_type: apiPageType
v1.0 Bitlockerrecoverykey Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bitlockerrecoverykey-get.md
Title: "Get bitlockerRecoveryKey"
description: "Retrieve the properties and relationships of a bitlockerRecoveryKey object." localization_priority: Normal doc_type: apiPageType
v1.0 Bundle Additem https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-additem.md
+ Title: Add item to a bundle description: Add item to a bundle of driveItems localization_priority: Normal
v1.0 Bundle Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-delete.md
+ Title: Delete bundle description: Delete a bundle of driveItems localization_priority: Normal
v1.0 Bundle Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-get.md
+ Title: Get bundle description: Get a bundle of driveItems localization_priority: Normal
GET https://graph.microsoft.com/beta/drive/bundles/{bundle-id}
<!-- { "blockType": "response", "@odata.type": "microsoft.graph.driveItem", "truncated": true } -->
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
used to request the next page of children in the bundle.
<!-- { "blockType": "response", "@odata.type": "microsoft.graph.driveItem", "truncated": true } -->
-```http
+```json
HTTP/1.1 200 OK Content-Type: application/json
v1.0 Bundle List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-list.md
+ Title: List bundles description: List the bundles in a user's drive localization_priority: Normal
Because all bundles are items, you can use use all the standard item operations
<!-- { "blockType": "response", "@odata.type": "microsoft.graph.driveItem", "truncated": true, "isCollection": true } -->
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Bundle Removeitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-removeitem.md
+ Title: Remove item from bundle description: Remove item from a bundle of driveItems localization_priority: Normal
v1.0 Bundle Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-update.md
+ Title: Update a bundle description: Update a bundle of driveItems localization_priority: Normal
This example renames a bundle.
# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "rename-bundle" } -->
-```http
+```json
PATCH https://graph.microsoft.com/beta/drive/items/{bundle-id} Content-Type: application/json
Content-Type: application/json
<!-- { "blockType": "response", "@odata.type": "microsoft.graph.driveItem", "truncated": true } -->
-```http
+```json
HTTP/1.1 200 OK Content-Type: application/json
v1.0 Businessflowtemplate List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/businessflowtemplate-list.md
Title: "List businessFlowTemplates"
description: "In the Azure AD access reviews feature, list all the businessFlowTemplate objects." localization_priority: Normal doc_type: apiPageType
v1.0 Calendar Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/calendar-delete.md
A user's [calendar](../resources/calendar.md) other than the default calendar in
```http DELETE /me/calendars/{id} DELETE /users/{id | userPrincipalName}/calendars/{id}+
+DELETE /me/calendarGroup/calendars/{id}
+DELETE /users/{id | userPrincipalName}/calendarGroup/calendars/{id}
``` A [calendar](../resources/calendar.md) other than the default calendar, in a specific [calendarGroup](../resources/calendargroup.md). ```http
v1.0 Calendar Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/calendar-get.md
A user's [calendar](../resources/calendar.md) in the default [calendarGroup](../
```http GET /me/calendars/{id} GET /users/{id | userPrincipalName}/calendars/{id}+
+GET /me/calendarGroup/calendars/{id}
+GET /users/{id | userPrincipalName}/calendarGroup/calendars/{id}
``` A user's [calendar](../resources/calendar.md) in a specific [calendarGroup](../resources/calendargroup.md). ```http
v1.0 Calendar List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/calendar-list-calendarview.md
A user's [calendar](../resources/calendar.md) in the default [calendarGroup](../
```http GET /me/calendars/{id}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime} GET /users/{id | userPrincipalName}/calendars/{id}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}+
+GET /me/calendarGroup/calendars/{id}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}
+GET /users/{id | userPrincipalName}/calendarGroup/calendars/{id}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}
``` A user's [calendar](../resources/calendar.md) in a specific [calendarGroup](../resources/calendargroup.md).
v1.0 Calendar List Events https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/calendar-list-events.md
A user's [calendar](../resources/calendar.md) in the default [calendarGroup](../
```http GET /me/calendars/{id}/events GET /users/{id | userPrincipalName}/calendars/{id}/events+
+GET /me/calendarGroup/calendars/{id}/events
+GET /users/{id | userPrincipalName}/calendarGroup/calendars/{id}/events
``` A user's [calendar](../resources/calendar.md) in a specific [calendarGroup](../resources/calendargroup.md). ```http
v1.0 Calendar Post Events https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/calendar-post-events.md
A user's [calendar](../resources/calendar.md) in the default [calendarGroup](../
```http POST /me/calendars/{id}/events POST /users/{id | userPrincipalName}/calendars/{id}/events+
+POST /me/calendarGroup/calendars/{id}/events
+POST /users/{id | userPrincipalName}/calendarGroup/calendars/{id}/events
``` A user's [calendar](../resources/calendar.md) in a specific [calendarGroup](../resources/calendargroup.md). ```http
v1.0 Calendar Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/calendar-update.md
A user's [calendar](../resources/calendar.md) in the default [calendarGroup](../
```http PATCH /me/calendars/{id} PATCH /users/{id | userPrincipalName}/calendars/{id}+
+PATCH /me/calendarGroup/calendars/{id}
+PATCH /users/{id | userPrincipalName}/calendarGroup/calendars/{id}
``` A user's [calendar](../resources/calendar.md) in a specific [calendarGroup](../resources/calendargroup.md). ```http
v1.0 Calendargroup List Calendars https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/calendargroup-list-calendars.md
One of the following permissions is required to call this API. To learn more, in
A user's default [calendarGroup](../resources/calendargroup.md). ```http
-GET /me/calendars
-GET /users/{id | userPrincipalName}/calendars
+GET /me/calendarGroup/calendars
+GET /users/{id | userPrincipalName}/calendarGroup/calendars
``` Any [calendarGroup](../resources/calendargroup.md) of a user.
v1.0 Calendargroup Post Calendars https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/calendargroup-post-calendars.md
One of the following permissions is required to call this API. To learn more, in
A user's default [calendarGroup](../resources/calendargroup.md). ```http
-POST /me/calendars
-POST /users/{id | userPrincipalName}/calendars
+POST /me/calendarGroup/calendars
+POST /users/{id | userPrincipalName}/calendarGroup/calendars
``` Any [calendarGroup](../resources/calendargroup.md) of a user.
v1.0 Call Answer https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/call-answer.md
POST /communications/calls/{id}/answer
## Request body In the request body, provide a JSON object with the following parameters.
-| Parameter | Type | Description |
-| :-- | :-- | :- |
-| callbackUri | String | Allows bots to provide a specific callback URI for the concurrent call to receive later notifications. If this property has not been set, the bot's global callback URI will be used instead. This must be `https`. |
-| acceptedModalities | String collection | The list of accept modalities. Possible value are: `audio`, `video`, `videoBasedScreenSharing`. Required for answering a call. |
-| mediaConfig | [appHostedMediaConfig](../resources/apphostedmediaconfig.md) or [serviceHostedMediaConfig](../resources/servicehostedmediaconfig.md) | The media configuration. Required. |
-| participantCapacity | Int | The number of participant that the application can handle for the call, for [Teams policy-based recording](/MicrosoftTeams/teams-recording-policy) scenario. |
+| Parameter | Type |Description |
+|:--|:--|:-|
+|callbackUri |String |Allows bots to provide a specific callback URI for the current call to receive later notifications. If this property has not been set, the bot's global callback URI will be used instead. This must be `https`. |
+|acceptedModalities|String collection |The list of accept modalities. Possible value are: `audio`, `video`, `videoBasedScreenSharing`. Required for answering a call. |
+|mediaConfig | [appHostedMediaConfig](../resources/apphostedmediaconfig.md) or [serviceHostedMediaConfig](../resources/servicehostedmediaconfig.md) |The media configuration. (Required) |
## Response This method returns a `202 Accepted` response code.
The following example shows how to call this API.
##### Request The following example shows the request. + # [HTTP](#tab/http) <!-- { "blockType": "request",
Content-Length: 211
}, "acceptedModalities": [ "audio"
- ],
- "participantCapacity": 200
+ ]
} ``` This blob is the serialized configuration for media sessions which is generated from the media SDK.
Content-Type: application/json
Under the [Policy-based recording scenario](/microsoftteams/teams-recording-policy), before a participant under policy joins a call, an incoming call notification will be sent to the bot associated with the policy. The join information can be found under the **botData** property. The bot can then choose to answer the call and [update the recording status](call-updaterecordingstatus.md) accordingly.
-When `participantCpapacity` is specified in the `Answer` request for a policy-based recording notification, subsequent participant joining event belonging to the same policy group will be sent out as [participantJoiningNotification](../resources/participantJoiningNotification.md) instead of
-new incoming call notification, until number of participants that current call instance is handling has reached the number specified in `participantCapacity`.
- The following is an example of the incoming call notification that a bot would recieve in this case. ```json
v1.0 Call Redirect https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/call-redirect.md
Content-Type: application/json
### Example 3: Forward a call to a PSTN number
-This call requires an application instance with a PSTN number assigned. For details, see [Assign a phone number to your bot](/graph/cloud-communications-phone-number#assign-a-phone-number-to-your-bot).
+This call requires an application instance with a PSTN number assigned.
+
+#### Step 1: Create application instance
+Using tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to create the application instance. For more information, see [New-CsOnlineApplicationInstance](/powershell/module/skype/new-csonlineapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <UPN> -DisplayName <DisplayName> -ApplicationId <AppId>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+#### Step 2: Assign Microsoft 365 licenses
+1. Use tenant admin credentials to sign in to https://admin.microsoft.com/ and go to the **Users -> Active users** tab.
+2. Select the application instance, assign **Microsoft 365 Domestic and International Calling Plan** and **Microsoft 365 Phone System - Virtual User** licenses, and click **Save changes**. If the required licenses are not available in the tenant, you can get them from the **Billing -> Purchase services** tab.
+#### Step 3: Acquire PSTN number
+1. Use tenant admin credentials to sign in to https://admin.teams.microsoft.com/ and click the **Legacy portal** tab on the left panel.
+2. In the new page, go to the **voice -> phone numbers** tab.
+3. Click the **+** button, select **New Service Numbers**, and go to the **Add new service numbers** page.
+4. Select **Country/Region**, **State/Region**, **City**, input **Quantity**, and click **add** to search. Click **acquire numbers**. The newly acquired number will show on the **phone numbers** tab.
+#### Step 4: Assign PSTN number to application instance
+With tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to assign the PSTN number to the application instance. For more information, see [Set-CsOnlineVoiceApplicationInstance](https://docs.microsoft.com/powershell/module/skype/set-csonlinevoiceapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](https://docs.microsoft.com/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <UPN> -TelephoneNumber <TelephoneNumber>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+> **Note:** If a tenant has Australian PSTN numbers assigned to any application instances, this call might fail. If a tenant is newly created, it might take several days for this feature to be available.
#### Notification - incoming <!-- {
v1.0 Call Transfer https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/call-transfer.md
Content-Type: application/json
### Example 3: Call transfer to PSTN number
-This call requires an application instance with a PSTN number assigned. For details, see [Assign a phone number to your bot](/graph/cloud-communications-phone-number#assign-a-phone-number-to-your-bot).
+This call requires an application instance with a PSTN number assigned.
+
+#### Step 1: Create application instance
+Using tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to create the application instance. For more information, see [New-CsOnlineApplicationInstance](/powershell/module/skype/new-csonlineapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <UPN> -DisplayName <DisplayName> -ApplicationId <AppId>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+#### Step 2: Assign Microsoft 365 licenses
+1. Use tenant admin credentials to sign in to https://admin.microsoft.com/ and go to the **Users -> Active users** tab.
+2. Select the application instance, assign **Microsoft 365 Domestic and International Calling Plan** and **Microsoft 365 Phone System - Virtual User** licenses, and click **Save changes**. If the required licenses are not available in the tenant, you can get them from the **Billing -> Purchase services** tab.
+#### Step 3: Acquire PSTN number
+1. Use tenant admin credentials to sign in to https://admin.teams.microsoft.com/ and click the **Legacy portal** tab on the left panel.
+2. In the new page, go to the **voice -> phone numbers** tab.
+3. Click the **+** button, select **New Service Numbers**, and go to the **Add new service numbers** page.
+4. Select **Country/Region**, **State/Region**, **City**, input **Quantity**, and click **add** to search. Click **acquire numbers**. The newly acquired number will show on the **phone numbers** tab.
+#### Step 4: Assign PSTN number to application instance
+With tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to assign the PSTN number to the application instance. For more information, see [Set-CsOnlineVoiceApplicationInstance](https://docs.microsoft.com/powershell/module/skype/set-csonlinevoiceapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](https://docs.microsoft.com/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <UPN> -TelephoneNumber <TelephoneNumber>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+> **Note:** If a tenant has Australian PSTN numbers assigned to any application instances, this call might fail. If a tenant is newly created, it might take several days for this feature to be available.
#### Request The following example shows the request.
Content-Type: application/json
### Example 4: Consultative transfer to PSTN number
-This call requires an application instance with a PSTN number assigned. For details, see [Assign a phone number to your bot](/graph/cloud-communications-phone-number#assign-a-phone-number-to-your-bot).
+This call requires an application instance with PSTN number assigned, as described in Example 3.
+
+> **Note:** This call may fail if a tenant has Australian PSTN numbers assigned to any application instances. If a tenant is newly created, it might take several days for this feature to be available.
+ #### Request The following example shows the request.
v1.0 Call Updatemetadata https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/call-updatemetadata.md
+
+ Title: "call: updateMetadata"
+description: "Update the appliation's metadata associated with a call."
+
+localization_priority: Normal
++
+# call: updateMetadata
+
+Namespace: microsoft.graph
++
+Update the appliation's metadata associated with a call.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | Not Supported |
+| Delegated (personal Microsoft account) | Not Supported |
+| Application | Calls.JoinGroupCallsasGuest.All, Calls.JoinGroupCalls.All, Calls.InitiateGroupCalls.All |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /app/calls/{id}/updateMetadata
+POST /communications/calls/{id}/updateMetadata
+```
+> **Note:** The `/app` path is deprecated. Going forward, use the `/communications` path.
+
+## Request headers
+| Name | Description |
+|:--|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+In the request body, provide a JSON object with the following parameters.
+
+| Parameter | Type |Description|
+|:|:--|:-|
+|metadata|String|A blob of data provided by the participant in the roster.|
+|clientContext|String|The client context.|
+
+## Response
+Returns `202 Accepted` response code and a Location header with a uri to the [commsOperation](../resources/commsoperation.md) created for this request.
+
+## Example
+The following example shows how to call this API.
+
+##### Request
+The following example shows the request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "call-updateMetadata"
+}-->
+```http
+POST https://graph.microsoft.com/beta/communications/calls/{id}/updateMetadata
+Content-Type: application/json
+Content-Length: 79
+
+{
+ "metadata": "metadata-value",
+ "clientContext": "clientContext-value"
+}
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
++++
+##### Response
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "blockType": "response",
+ "name": "call-updateMetadata",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.commsOperation"
+} -->
+```http
+HTTP/1.1 200 OK
+Location: https://graph.microsoft.com/beta/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896/operations/0fe0623f-d628-42ed-b4bd-8ac290072cc5
+
+{
+ "@odata.type": "#microsoft.graph.commsOperation",
+ "clientContext": "clientContext-value",
+ "id": "0fe0623f-d628-42ed-b4bd-8ac290072cc5",
+ "resultInfo": null,
+ "status": "completed"
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "call: updateMetadata",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Callrecords Callrecord Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/callrecords-callrecord-get.md
If successful, this method returns a `200 OK` response code and the requested [m
The following is an example of the request to get the basic details from a [callRecord](../resources/callrecords-callrecord.md). -
-# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "get_callrecord" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/beta/communications/callRecords/{id} ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- #### Response
The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. <!-- {
- "blockType": "response",
+ "blockType": "ignored",
"truncated": true, "@odata.type": "microsoft.graph.callRecords.callRecord" } -->
Content-type: application/json
The following is an example of the request to get the full details from a [callRecord](../resources/callrecords-callrecord.md), including session and segment components. -
-# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "get_callrecord_expanded" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/beta/communications/callRecords/{id}?$expand=sessions($expand=segments) ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- #### Response
The following is an example of the response. If the sessions list is truncated,
> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. <!-- {
- "blockType": "response",
+ "blockType": "ignored",
"truncated": true, "@odata.type": "microsoft.graph.callRecords.callRecord" } -->
v1.0 Callrecords Session List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/callrecords-session-list.md
If successful, this method returns a `200 OK` response code and the requested [s
The following is an example of the request to get the list of [sessions](../resources/callrecords-session.md) for a [callRecord](../resources/callrecords-callrecord.md). -
-# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "get_callrecord_sessions" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/beta/communications/callRecords/{id}/sessions ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- #### Response
The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. <!-- {
- "blockType": "response",
+ "blockType": "ignored",
"truncated": true, "@odata.type": "microsoft.graph.callRecords.session", "isCollection": true
Content-type: application/json
The following is an example of the request to get the list of [sessions](../resources/callrecords-session.md) for a [callRecord](../resources/callrecords-callrecord.md) with [segments](../resources/callrecords-segment.md) included. -
-# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "get_callrecord_sessions_expanded" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/beta/communications/callRecords/{id}/sessions?$expand=segments ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- #### Response
The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. <!-- {
- "blockType": "response",
+ "blockType": "ignored",
"truncated": true, "@odata.type": "microsoft.graph.callRecords.session", "isCollection": true
v1.0 Certificatebasedauthconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/certificatebasedauthconfiguration-delete.md
Title: "Delete certificateBasedAuthConfiguration"
description: "Delete certificateBasedAuthConfiguration." localization_priority: Normal doc_type: "apiPageType"
v1.0 Certificatebasedauthconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/certificatebasedauthconfiguration-get.md
Title: "Get certificateBasedAuthConfiguration"
description: "Get the properties of a certificatebasedauthconfiguration object." localization_priority: Normal doc_type: "apiPageType"
v1.0 Certificatebasedauthconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/certificatebasedauthconfiguration-list.md
Title: "List certificateBasedAuthConfigurations"
description: "Get a list of certificatebasedauthconfiguration objects." localization_priority: Normal doc_type: "apiPageType"
v1.0 Certificatebasedauthconfiguration Post Certificatebasedauthconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/certificatebasedauthconfiguration-post-certificatebasedauthconfiguration.md
Title: "Create certificateBasedAuthConfiguration"
description: "Use this API to create a new certificateBasedAuthConfiguration." localization_priority: Normal doc_type: "apiPageType"
v1.0 Channel Post Message https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/channel-post-message.md
Namespace: microsoft.graph
Create a new [chatMessage](../resources/chatmessage.md) in the specified [channel](../resources/channel.md).
+> **Note**: We don't recommend that you use this API for data migration. It does not have the throughput necessary for a typical migration.
+ > **Note**: It is a violation of the [terms of use](/legal/microsoft-apis/terms-of-use) to use Microsoft Teams as a log file. Only send messages that people will read. ## Permissions
One of the following permissions is required to call this API. To learn more, in
| Delegated (personal Microsoft account) | Not supported. | | Application | Teamwork.Migrate.All |
-> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams).
- <!-- markdownlint-disable MD024 --> <!-- markdownlint-disable MD001 --> <!-- markdownlint-disable MD022 -->
v1.0 Channel Post Messagereply https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/channel-post-messagereply.md
Namespace: microsoft.graph
Create a new reply to a [chatMessage](../resources/chatmessage.md) in a specified [channel](../resources/channel.md).
+> **Note**: We don't recommend that you use this API for data migration. It does not have the throughput necessary for a typical migration.
+ > **Note**: It is a violation of the [terms of use](/legal/microsoft-apis/terms-of-use) to use Microsoft Teams as a log file. Only send messages that people will read. <!-- markdownlint-disable MD024 --> <!-- markdownlint-disable MD022 -->
Create a new reply to a [chatMessage](../resources/chatmessage.md) in a specifie
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-| Permission type | Permissions (from least to most privileged) |
-|:|:--|
-| Delegated (work or school account) | ChannelMessage.Send, Group.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Teamwork.Migrate.All |
-
-> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams).
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | ChannelMessage.Send, Group.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Teamwork.Migrate.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Chart Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chart-delete.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-DELETE /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}
-DELETE /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}
+POST /workbook/worksheets/{id|name}/charts/{name}/delete
+ ``` ## Request headers | Name | Description|
Here is an example of the request.
"name": "chart_delete" }--> ```http
-DELETE https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}
+POST https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/delete
``` ##### Response
v1.0 Chart Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chart-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}
+GET /workbook/worksheets/{id|name}/charts/{name}
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chart Image https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chart-image.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/Image(width=0,height=0,fittingMode='fit')
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/Image(width=0,height=0,fittingMode='fit')
+GET /workbook/worksheets/{id|name}/charts/{name}/Image(width=0,height=0,fittingMode='fit')
``` ## Request headers
v1.0 Chart List Series https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chart-list-series.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/series
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/series
+GET /workbook/worksheets/{id|name}/charts/{name}/series
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chart List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chart-list.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts
+GET /workbook/worksheets/{id|name}/charts
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chart Post Series https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chart-post-series.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/series
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/series
+POST /workbook/worksheets/{id|name}/charts/{name}/series
``` ## Request headers
v1.0 Chart Setdata https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chart-setdata.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/setData
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/setData
+POST /workbook/worksheets/{id|name}/charts/{name}/setData
``` ## Request headers
v1.0 Chart Setposition https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chart-setposition.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/setPosition
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/setPosition
+POST /workbook/worksheets/{id|name}/charts/{name}/setPosition
``` ## Request headers
v1.0 Chart Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chart-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}
+PATCH /workbook/worksheets/{id|name}/charts/{name}
``` ## Optional request headers | Name | Description|
v1.0 Chartaxis Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartaxis-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartaxis Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartaxis-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis
``` ## Optional request headers | Name | Description|
v1.0 Chartaxistitle Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartaxistitle-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/title
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/title
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/title
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/title
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/title
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/title
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/title
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/title
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/title
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartaxistitle Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartaxistitle-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/title
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/title
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/title
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/title
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/title
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/title
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/title
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/title
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/title
``` ## Optional request headers | Name | Description|
v1.0 Chartcollection Add https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartcollection-add.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/add
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/add
+POST /workbook/worksheets/{id|name}/charts/add
``` ## Request headers
v1.0 Chartcollection Itemat https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartcollection-itemat.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/ItemAt
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/ItemAt
+POST /workbook/worksheets/{id|name}/charts/ItemAt
``` ## Request headers
v1.0 Chartdatalabels Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartdatalabels-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/datalabels
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/datalabels
+GET /workbook/worksheets/{id|name}/charts/{name}/datalabels
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartdatalabels Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartdatalabels-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/datalabels
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/datalabels
+PATCH /workbook/worksheets/{id|name}/charts/{name}/datalabels
``` ## Optional request headers | Name | Description|
v1.0 Chartfill Clear https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartfill-clear.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/format/fill/clear
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/format/fill/clear
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/title/format/fill/clear
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/title/format/fill/clear
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/legend/format/fill/clear
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/legend/format/fill/clear
+POST /workbook/worksheets/{id|name}/charts/{name}/format/fill/clear
+POST /workbook/worksheets/{id|name}/charts/{name}/title/format/fill/clear
+POST /workbook/worksheets/{id|name}/charts/{name}/legend/format/fill/clear
``` ## Request headers
v1.0 Chartfill Setsolidcolor https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartfill-setsolidcolor.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/format/fill/setSolidColor
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/format/fill/setSolidColor
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/title/format/fill/setSolidColor
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/title/format/fill/setSolidColor
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/legend/format/fill/setSolidColor
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/legend/format/fill/setSolidColor
+POST /workbook/worksheets/{id|name}/charts/{name}/format/fill/setSolidColor
+POST /workbook/worksheets/{id|name}/charts/{name}/title/format/fill/setSolidColor
+POST /workbook/worksheets/{id|name}/charts/{name}/legend/format/fill/setSolidColor
``` ## Request headers
v1.0 Chartfont Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartfont-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/format/font
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/format/font
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/font
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/font
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/font
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/font
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/format/font
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/font
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/font
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartfont Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartfont-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/format/font
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/format/font
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/font
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/font
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/font
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/font
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/format/font
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/font
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/font
``` ## Optional request headers | Name | Description|
v1.0 Chartgridlines Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartgridlines-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/minorgridlines
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/minorgridlines
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/majorgridlines
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/majorgridlines
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/minorgridlines
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/majorgridlines
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartgridlines Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartgridlines-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/minorgridlines
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/minorgridlines
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/majorgridlines
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/majorgridlines
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/minorgridlines
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/valueaxis/majorgridlines
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines
``` ## Optional request headers | Name | Description|
v1.0 Chartlegend Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartlegend-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/legend
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/legend
+GET /workbook/worksheets/{id|name}/charts/{name}/legend
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartlegend Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartlegend-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/legend
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/legend
+PATCH /workbook/worksheets/{id|name}/charts/{name}/legend
``` ## Optional request headers | Name | Description|
v1.0 Chartlineformat Clear https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartlineformat-clear.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/line/clear
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/line/clear
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/line/clear
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/line/clear
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines/format/line/clear
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines/format/line/clear
+POST /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/line/clear
+POST /workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/line/clear
+POST /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines/format/line/clear
``` ## Request headers
v1.0 Chartlineformat Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartlineformat-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/line
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/line
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/line
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/line
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines/format/line
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines/format/line
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/line
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/line
+GET /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines/format/line
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartlineformat Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartlineformat-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/line
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/line
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/line
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/line
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines/format/line
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines/format/line
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/format/line
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/categoryaxis/format/line
+PATCH /workbook/worksheets/{id|name}/charts/{name}/axes/seriesaxis/majorgridlines/format/line
``` ## Optional request headers | Name | Description|
v1.0 Chartpoint Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartpoint-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points/{undefined}
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points/{undefined}
+GET /workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points/{undefined}
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartpoint List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartpoint-list.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points
+GET /workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartpointscollection Itemat https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartpointscollection-itemat.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points/ItemAt
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points/ItemAt
+POST /workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points/ItemAt
``` ## Request headers
v1.0 Chartseries Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartseries-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}
+GET /workbook/worksheets/{id|name}/charts/{name}/series/{undefined}
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartseries List Points https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartseries-list-points.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points
+GET /workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartseries List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartseries-list.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/series
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/series
+GET /workbook/worksheets/{id|name}/charts/{name}/series
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Chartseries Post Points https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartseries-post-points.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points
+POST /workbook/worksheets/{id|name}/charts/{name}/series/{undefined}/points
``` ## Request headers
v1.0 Chartseries Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartseries-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/series/{undefined}
+PATCH /workbook/worksheets/{id|name}/charts/{name}/series/{undefined}
``` ## Optional request headers | Name | Description|
v1.0 Chartseriescollection Itemat https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chartseriescollection-itemat.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/series/ItemAt
-POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/series/ItemAt
+POST /workbook/worksheets/{id|name}/charts/{name}/series/ItemAt
``` ## Request headers
v1.0 Charttitle Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/charttitle-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/title
-GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/title
+GET /workbook/worksheets/{id|name}/charts/{name}/title
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Charttitle Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/charttitle-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/title
-PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/title
+PATCH /workbook/worksheets/{id|name}/charts/{name}/title
``` ## Optional request headers | Name | Description|
v1.0 Chatmessage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessage-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /teams/(team-id)/channels/{channel-id}/messages/{message-id}
-PATCH /chats/{chatThread-id}/messages/{message-id}
+PATCH /teams/(team-id)/channels/{channel-id}/chatMessages/{message-id}
+PATCH /users/(user-id)/chats/{chatThread-id}/chatMessages/{message-id}
``` ## Request headers
v1.0 Claimsmappingpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/claimsmappingpolicy-delete.md
Title: "Delete claimsMappingPolicy"
description: "Delete claimsMappingPolicy." localization_priority: Normal doc_type: "apiPageType"
v1.0 Claimsmappingpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/claimsmappingpolicy-get.md
Title: "Get claimsMappingPolicy"
description: "Retrieve the properties and relationships of claimsMappingPolicy object." localization_priority: Normal doc_type: "apiPageType"
v1.0 Claimsmappingpolicy List Appliesto https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/claimsmappingpolicy-list-appliesto.md
Title: "List appliesTo"
description: "Get a list of directoryObject objects that a claimsMappingPolicy object has been applied to." localization_priority: Normal doc_type: "apiPageType"
The following is an example of the request.
}--> ```http
-GET https://graph.microsoft.com/beta/policies/claimsMappingPolicies/{id}/appliesTo
+GET https://graph.microsoft.com/beta/claimsMappingPolicies/{id}/appliesTo
``` ### Response
v1.0 Claimsmappingpolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/claimsmappingpolicy-list.md
Title: "List claimsMappingPolicies"
description: "Get a list of claimsMappingPolicy objects." localization_priority: Normal doc_type: "apiPageType"
v1.0 Claimsmappingpolicy Post Claimsmappingpolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/claimsmappingpolicy-post-claimsmappingpolicies.md
Title: "Create claimsMappingPolicy"
description: "Create a new claimsMappingPolicy." localization_priority: Normal doc_type: "apiPageType"
v1.0 Claimsmappingpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/claimsmappingpolicy-update.md
Title: "Update claimsmappingpolicy"
description: "Update the properties of claimsMappingPolicy object." localization_priority: Normal doc_type: "apiPageType"
v1.0 Cloudpconpremisesconnection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpconpremisesconnection-get.md
Content-Type: application/json
"resourceGroupId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG", "virtualNetworkId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet", "subnetId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default",
- "healthCheckStatus": "running"
+ "healthCheckStatus": "running",
+ "inUse": false
} } ```
Content-Type: application/json
--> ``` http
-GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/onPremisesConnections/{id}?$select=id,displayName,healthCheckStatus,healthCheckStatusDetails,inUse
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/onPremisesConnections/{id}?$select=id,displayName,subscriptionId,subscriptionName,adDomainName,adDomainUsername,organizationalUnit,virtualNetworkId,subnetId,healthCheckStatus,healthCheckStatusDetails,inUse
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-cloudpconpremisesconnection-withdetails-csharp-snippets.md)]
Content-Type: application/json
"@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection", "id": "9ec90ff8-fd63-4fb9-ab5a-aa4fdccffff", "displayName": "Display Name value",
+ "subscriptionId": "0ac520ee-14c0-480f-b6c9-0a90c585ffff",
+ "subscriptionName": "Subscription Name value",
+ "adDomainName": "Active Directory Domain Name value",
+ "adDomainUsername": "Active Directory Domain User Name value",
+ "organizationalUnit": "Organization Unit value",
+ "resourceGroupId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG",
+ "virtualNetworkId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet",
+ "subnetId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default",
"healthCheckStatus": "failed", "healthCheckStatusDetails": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails",
v1.0 Cloudpconpremisesconnection Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpconpremisesconnection-update.md
Content-length: 897
"resourceGroupId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG", "virtualNetworkId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet", "subnetId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default",
- "healthCheckStatus": "running"
+ "healthCheckStatus": "running",
+ "inUse": false
} ```
v1.0 Cloudpconpremisesconnection Updateaddomainpassword https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpconpremisesconnection-updateaddomainpassword.md
If successful, this action returns a `204 No Content` response code.
## Examples ### Request-
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpconpremisesconnection_updateaddomainpassword"
Content-length: 36
"adDomainPassword": "AdDomainPassword value" } ```
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
--- ### Response
v1.0 Conditionalaccesspolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conditionalaccesspolicy-delete.md
Title: "Delete conditionalAccessPolicy"
description: "Delete a conditionalAccessPolicy." localization_priority: Normal doc_type: apiPageType
v1.0 Conditionalaccesspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conditionalaccesspolicy-get.md
Title: "Get conditionalAccessPolicy"
description: "Retrieve the properties and relationships of a conditionalAccessPolicy object." localization_priority: Normal doc_type: apiPageType
Content-type: application/json
}, "deviceStates": null, "devices": {
- "includeDevices": [
+ "includeDeviceStates": [
"All" ],
- "excludeDevices": [
+ "excludeDeviceStates": [
"Compliant" ] }
v1.0 Conditionalaccesspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conditionalaccesspolicy-update.md
Title: "Update conditionalAccessPolicy"
description: "Update the properties of a conditionalAccessPolicy object." localization_priority: Normal doc_type: apiPageType
v1.0 Conditionalaccessroot List Namedlocations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conditionalaccessroot-list-namedlocations.md
Title: "List namedLocations"
description: "Get a list of namedLocation objects." localization_priority: Normal doc_type: apiPageType
v1.0 Conditionalaccessroot List Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conditionalaccessroot-list-policies.md
Title: "List policies"
description: "Retrieve a list of conditionalAccessPolicy objects." localization_priority: Normal doc_type: apiPageType
v1.0 Conditionalaccessroot Post Namedlocations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conditionalaccessroot-post-namedlocations.md
Title: "Create namedLocation"
description: "Create a new namedLocation." localization_priority: Normal doc_type: apiPageType
v1.0 Conditionalaccessroot Post Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conditionalaccessroot-post-policies.md
Title: "Create conditionalAccessPolicy"
description: "Create a new conditionalAccessPolicy." localization_priority: Normal doc_type: apiPageType
Content-type: application/json
"includeGroups": ["ba8e7ded-8b0f-4836-ba06-8ff1ecc5c8ba"] }, "devices": {
- "includeDevices": [
+ "includeDeviceStates": [
"All" ],
- "excludeDevices": [
+ "excludeDeviceStates": [
"Compliant" ] }
Content-type: application/json
"excludeRoles": [] }, "devices": {
- "includeDevices": [
+ "includeDeviceStates": [
"All" ],
- "excludeDevices": [
+ "excludeDeviceStates": [
"Compliant" ] }
v1.0 Connectedorganization Delete Externalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-delete-externalsponsors.md
Title: "Remove connected organization external sponsor"
description: "Remove a user or group from the connected organization's external sponsors." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | EntitlementManagement.ReadWrite.All |
+|Application | Not supported. |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Connectedorganization Delete Internalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-delete-internalsponsors.md
Title: "Remove connected organization internal sponsor"
description: "Remove a user or group from the connected organization's internal sponsors." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | EntitlementManagement.ReadWrite.All |
+|Application | Not supported. |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Connectedorganization Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-delete.md
Title: "Delete connectedOrganization"
description: "Delete connectedOrganization." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Connectedorganization Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-get.md
Title: "Get connectedOrganization" description: "Retrieve the properties and relationships of a connectedorganization object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Connectedorganization List Externalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-list-externalsponsors.md
Title: "List externalSponsors"
description: "Retrieve a list of connectedOrganization's externalSponsors." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Connectedorganization List Internalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-list-internalsponsors.md
Title: "List internalSponsors"
description: "Retrieve a list of connectedOrganization's internalSponsors." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Connectedorganization List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-list.md
Title: "List connectedOrganizations"
description: "Retrieve a list of connectedOrganization objects." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Connectedorganization Post Externalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-post-externalsponsors.md
Title: "Add connected organization external sponsor"
description: "Add a user or group to the connected organization's external sponsors." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | EntitlementManagement.ReadWrite.All |
+|Application | Not supported. |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Connectedorganization Post Internalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-post-internalsponsors.md
Title: "Add connected organization internal sponsor"
description: "Add a user or group to the connected organization's internal sponsors." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | EntitlementManagement.ReadWrite.All |
+|Application | Not supported. |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Connectedorganization Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-post.md
Title: "Create connectedOrganization"
description: "Create a new connectedOrganization." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | EntitlementManagement.ReadWrite.All |
+| Application | Not supported. |
## HTTP request
v1.0 Connectedorganization Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-update.md
Title: "Update a connectedOrganization object"
description: "Update a connectedOrganization object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | EntitlementManagement.ReadWrite.All |
+|Application | Not supported. |
## HTTP request
PATCH /identityGovernance/entitlementManagement/connectedOrganizations/{id}
## Request body In the request body, supply a JSON representation of the [connectedOrganization](../resources/connectedorganization.md) object.
-The following table shows the properties that can be supplied when you update the [connectedOrganization](../resources/connectedorganization.md).
+The following table shows the properties that are required when you update the [connectedOrganization](../resources/connectedorganization.md).
|Property|Type|Description| |:|:|:|
v1.0 Connector Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connector-get.md
Title: "Get connector"
description: "Retrieve the properties of a connector object." localization_priority: Normal doc_type: "apiPageType"
Content-length: 124
"suppressions": [] } -->-
v1.0 Connector List Memberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connector-list-memberof.md
Title: "List memberOf"
description: "Retrieve the connectorgroup the connector is a member of." localization_priority: Normal doc_type: "apiPageType"
Content-length: 164
"suppressions": [] } -->-
v1.0 Connector List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connector-list.md
Title: "List connectors"
description: "Retrieve a list of connector objects." localization_priority: Normal doc_type: "apiPageType"
Content-length: 169
"suppressions": [] } -->-
v1.0 Connector Post Memberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connector-post-memberof.md
Title: "Add Connector to connectorGroup"
description: "Use this API to add a connector to a new connectorGroup." localization_priority: Normal doc_type: "apiPageType"
Content-length: 119
--> -
v1.0 Connectorgroup Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectorgroup-delete.md
Title: "Delete connectorGroup"
description: "Delete a connectorGroup." localization_priority: Normal doc_type: "apiPageType"
HTTP/1.1 204 No Content
--> -
v1.0 Connectorgroup Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectorgroup-get.md
Title: "Get connectorGroup"
description: "Retrieve the properties of a connectorGroup object." localization_priority: Normal doc_type: "apiPageType"
Content-length: 119
"suppressions": [] } -->-
v1.0 Connectorgroup List Applications https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectorgroup-list-applications.md
Title: "List applications"
description: "Retrieve a list of application objects associated with the connectorGroup." localization_priority: Normal doc_type: "apiPageType"
Content-length: 420
"suppressions": [] } -->-
v1.0 Connectorgroup List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectorgroup-list-members.md
Title: "List members"
description: "Retrieve a list of connector objects associated with a connectorGroup." localization_priority: Normal doc_type: "apiPageType"
Content-length: 169
"suppressions": [] } -->-
v1.0 Connectorgroup List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectorgroup-list.md
Title: "List connectorGroups"
description: "Retrieve a list of connectorgroup objects." localization_priority: Normal doc_type: "apiPageType"
Content-length: 164
"suppressions": [] } -->-
v1.0 Connectorgroup Post Applications https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectorgroup-post-applications.md
Title: "Assign a connectorGroup to an application"
description: "Use this API to assign a connectorGroup to an application" localization_priority: Normal doc_type: "apiPageType" # Assign a connectorGroup to an application
HTTP/1.1 204 No content
--> -
v1.0 Connectorgroup Post Connectorgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectorgroup-post-connectorgroups.md
Title: "Create connectorGroup"
description: "Use this API to create a new connectorGroup." localization_priority: Normal doc_type: "apiPageType"
Content-length: 119
--> -
v1.0 Connectorgroup Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectorgroup-post-members.md
Title: "Add connector to connectorGroup"
description: "Use this API to add a connector to a connectorGroup." localization_priority: Normal doc_type: "apiPageType"
HTTP/1.1 204 No Content
--> -
v1.0 Connectorgroup Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectorgroup-post.md
Title: "Create connectorGroup"
description: "Create a connectorGroup object." localization_priority: Normal doc_type: "apiPageType"
Content-length: 119
--> -
v1.0 Connectorgroup Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectorgroup-update.md
Title: "Update connectorGroups"
description: "Update the properties of connectorgroup object." localization_priority: Normal doc_type: "apiPageType"
Content-length: 119
--> -
v1.0 Contact Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contact-delete.md
DELETE /users/{id | userPrincipalName}/contactFolders/{id}/contacts/{id}
A [contact](../resources/contact.md) contained in a child folder of a [contactFolder](../resources/mailfolder.md). The example below shows one level of nesting, but a contact can be located in a child of a child and so on. ```http
-DELETE /me/contactFolders/{id}/childFolders/{id}/.../contacts/{id}
+DELETE /me/contactFolder/{id}/childFolders/{id}/.../contacts/{id}
DELETE /users/{id | userPrincipalName}/contactFolders/{id}/childFolders/{id}/contacts/{id} ``` ## Request headers
v1.0 Contact Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contact-get.md
GET /users/{id | userPrincipalName}/contactfolders/{id}/contacts/{id}
A [contact](../resources/contact.md) contained in a child folder of a [contactFolder](../resources/mailfolder.md). The example below shows one level of nesting, but a contact can be located in a child of a child and so on. ```http
-GET /me/contactFolders/{id}/childFolders/{id}/.../contacts/{id}
+GET /me/contactFolder/{id}/childFolders/{id}/.../contacts/{id}
GET /users/{id | userPrincipalName}/contactFolders/{id}/childFolders/{id}/contacts/{id} ``` ## Optional query parameters
v1.0 Contact Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contact-update.md
PATCH /users/{id | userPrincipalName}/contactFolders/{id}/contacts/{id}
A [contact](../resources/contact.md) contained in a child folder of a [contactFolder](../resources/mailfolder.md). The example below shows one level of nesting, but a contact can be located in a child of a child and so on. ```http
-PATCH /me/contactFolders/{id}/childFolders/{id}/.../contacts/{id}
+PATCH /me/contactFolder/{id}/childFolders/{id}/.../contacts/{id}
PATCH /users/{id | userPrincipalName}/contactFolders/{id}/childFolders/{id}/contacts/{id} ``` ## Request headers
v1.0 Contenttype Addcopy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-addcopy.md
-- Title: "contentType: addCopy"
-description: "Add a copy of a site content type to a list."
-localization_priority: Normal
-doc_type: apiPageType
--
-# contentType: addCopy
-Namespace: microsoft.graph
-
-Add a copy of a [site][site] [content type][contentType] to a [list][list].
-
-
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-
-
-## HTTP request
-<!-- {
- "blockType": "ignored"
-}
>
-```http
-
-POST /sites/{site-id}/lists/{list-id}/contentTypes/addCopy
-```
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|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|
-|-|-|-|
-|contentType| string | Canonical URL to the site content type that will be copied to the list. Required.|
-
-## Response
-
-If successful, this call returns a `204 No Content` response.
-
-## Example
-
-### Request
-<!-- {
- "blockType": "request",
- "name": "contenttype_addcopy"
-}
>
-```http
-POST https://graph.microsoft.com/beta/sites/id/lists/{list-id}/contentTypes/addCopy
-Content-Type: application/json
-
-{
- "contentType": "https://graph.microsoft.com/beta/sites/id/contentTypes/0x0101"
-}
-```
---
-### Response
--
-<!-- { "blockType": "response" } -->
-
-```http
-HTTP/1.1 204 No Content
-
-```
-
-[site]: ../resources/site.md
-[list]: ../resources/list.md
-[contentType]: ../resources/contentType.md
v1.0 Contenttype Associatewithhubsites https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-associatewithhubsites.md
-- Title: "contentType: associateWithHubSites"
-description: "Associate a content type with list of hubsites."
-localization_priority: Normal
-doc_type: apiPageType
--
-# contentType: associateWithHubSites
-
-Namespace: microsoft.graph
-
-Associate a [content type][contentType] with a list of hub sites.
-
->**Note:** This feature is limited to tenants that have a SharePoint Syntex license.
-
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:
-|Delegated (work or school account) | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-
-
-## HTTP request
-<!-- {
- "blockType": "ignored"
-}
>
-```http
-POST /sites/id/contentTypes/id/associateWithHubSites
-```
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|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|
-|-|-|-|
-|hubSiteUrls| Collection(string) |List of cannonical URLs to the hub sites where the content type needs to be enforced. Required.|
-|propagateToExistingLists| Boolean |If `true`, content types will be enforced on existing lists in the hub sites; otherwise, it will be applied only to newly created lists.
-
-## Response
-
-If successful, this action returns a `204 No Content` response code.
-
-## Example
-
-### Request
-<!-- {
- "blockType": "request",
- "name": "contenttype_associatewithhubsites"
-}
>
-```http
-POST https://graph.microsoft.com/beta/sites/id/contentTypes/id/associateWithHubSites
-Content-Type: application/json
-
-{
- "hubSiteUrls":
- [
- "https://graph.microsoft.com/beta/sites/id"
-
- ],
- "propagateToExistingLists": false
-}
-```
---
-### Response
--
-<!-- { "blockType": "response" } -->
-
-```http
-HTTP/1.1 204 No Content
-
-```
-
-
-
-[contentType]: ../resources/contentType.md
v1.0 Contenttype Copytodefaultcontentlocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-copytodefaultcontentlocation.md
-- Title: "contentType: copyToDefaultContentLocation"
-description: "Copy a file to a default content location in a content type."
-localization_priority: Normal
-doc_type: apiPageType
--
-# contentType: copyToDefaultContentLocation
-Namespace: microsoft.graph
-
-Copy a file to a default content location in a [content type][contentType]. The file can then be added as a default file or template via a POST operation.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-```http
-
-POST /sites/id/contentTypes/id/copyToDefaultContentLocation
-```
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|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|
-|-|-|-|
-|sourceFile| [itemReference](../resources/itemreference.md) |Metadata about the source file that needs to be copied to the default content location. Required.|
-|destinationFileName| string |Destination filename.
-
-## Response
--
-If successful, this call returns a `204 No Content` response.
-
-## Example
-
-### Request
-<!-- {
- "blockType": "request",
- "name": "contenttype_copytodefaultcontentlocation"
-}
>
-```http
-POST https://graph.microsoft.com/beta/sites/{id}/contentTypes/{contentTypeId}/copyToDefaultContentLocation
-Content-Type: application/json
-
-{
- "sourceFile": {
- "sharepointIds": {
- "listId": "e2ecf63b-b0fd-48f7-a54a-d8c15479e3b0",
- "listItemId": "2"
- }
- },
- "destinationFileName": "newname.txt"
-}
-```
---
-### Response
--
-<!-- { "blockType": "response" } -->
-
-```http
-HTTP/1.1 204 No Content
-
-```
-
-
-
-[contentType]: ../resources/contentType.md
v1.0 Contenttype Delete Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-delete-columns.md
-- Title: "Delete columnDefinition"
-description: "Delete a column from a content type."
-localization_priority: Normal
-doc_type: apiPageType
--
-# Delete columnDefinition
-Namespace: microsoft.graph
-
-Remove a [column][columndefinition] from a [list][] or a [site][] [content type][contentType].
--
-## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-DELETE /sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
-DELETE /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}/columns/{column-id}
-```
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `204 No Content` response code.
-
-## Example
-
-### Request
-<!-- {
- "blockType": "request",
- "name": "delete_columns_from_contenttype"
-}
>-
-```http
-DELETE https://graph.microsoft.com/beta/sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>
-```http
-HTTP/1.1 204 No Content
-```
-
-[list]: ../resources/list.md
-[columndefinition]: ../resources/columndefinition.md
-[contentType]: ../resources/contentType.md
-[site]: ../resources/site.md
v1.0 Contenttype Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-delete.md
-- Title: "Delete contentType"
-description: "Delete a content type from a sharepoint list or a site."
-localization_priority: Normal
-doc_type: apiPageType
--
-# Delete contentType
-Namespace: microsoft.graph
--
-Remove a [content type][contentType] from a [list][] or a [site][].
--
-## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-DELETE /sites/{site-id}/contentTypes/{contentType-id}
-DELETE /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}
-```
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
--
-## Request body
-
-Do not supply a request body with this method.
-
-## Response
-
-If successful, this method returns a `204 No Content` response code.
-
-## Example
-
-### Request
-<!-- {
- "blockType": "request",
- "name": "delete_contenttype"
-}
>-
-```http
-DELETE https://graph.microsoft.com/beta/sites/{site-id}/contentTypes/{contentType-id}
-```
-
-### Response
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>-
-```http
-HTTP/1.1 204 No Content
-```
-
-[list]: ../resources/list.md
-[contentType]: ../resources/contentType.md
-[site]: ../resources/site.md
v1.0 Contenttype Get Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-get-columns.md
-- Title: "Get columnDefinition"
-description: " Get a content type column."
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get columnDefinition
-Namespace: microsoft.graph
-
-Retrieve the metadata for a [contentType][] [column][columnDefinition].
-
-
-
-## Permissions
-
-
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-```http
-
-GET /sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
-GET /sites/{site-id}/lists/{list-id}//contentTypes/{contentType-id}/columns/{column-id}
-```
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-
-
-Do not supply a request body with this method.
-
-
-
-## Example
-
-
-
-### Request
-
-
-
-<!-- { "blockType": "request", "name": "get_column_from_contenttype" } -->
-
-
-
-```http
-GET /sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
-```
-
-
-
-#### Response
-
-
-
-<!-- { "blockType": "response", "@type": "microsoft.graph.columnDefinition", "truncated": true } -->
-
-
-
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "description": "",
- "displayName": "Title",
- "hidden": false,
- "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103",
- "indexed": false,
- "name": "Title",
- "readOnly": false,
- "required": false,
- "text": {
- "allowMultipleLines": false,
- "appendChangesToExistingText": false,
- "linesForEditing": 0,
- "maxLength": 255
- }
-}
-```
-
-
-
-[columnDefinition]: ../resources/columnDefinition.md
-
-[list]: ../resources/list.md
-
-[site]: ../resources/site.md
-
-[contentType]: ../resources/contentType.md
-
v1.0 Contenttype Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-get.md
-- Title: "Get contentType"
-description: "Get a content type in a site or a list."
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get contentType
-Namespace: microsoft.graph
--
-Retrieve the metadata for a [content type][contentType] in a [site][] or a [list][].
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-## HTTP request
-<!-- {
- "blockType": "ignored"
-}
>
-```http
-GET /sites/{site-id}/contentTypes/{contentType-id}
-
-GET /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}
-```
-
-## Optional query parameters
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a [contentType](../resources/contenttype.md) object in the response body.
--
-## Example
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "get_contenttype"
-}
>-
-```http
-GET https://graph.microsoft.com/beta/sites/{site-id}/contentTypes/{contentType-id}
-```
-
-### Response
->**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.contentType"
-}
>-
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "id":"0x0120D520",
- "description":"Create a document set when you want to manage multiple documents as a single work product.",
- "group":"Document Set Content Types",
- "hidden":false,
- "name":"Document Set",
- "base": {
- "name": "Document Set",
- "id": "0x0120D520"
- }
-}
-```
-
-[contentType]: ../resources/contentType.md
-[site]: ../resources/site.md
-[list]: ../resources/list.md
v1.0 Contenttype Ispublished https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-ispublished.md
-- Title: "contentType: isPublished"
-description: "Check the publishing status of a content type in a content type hub site."
-localization_priority: Normal
-doc_type: apiPageType
--
-# contentType: isPublished
-Namespace: microsoft.graph
-
-Check the publishing status of a [contentType][] in a content type hub site.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not Supported |
-|Application | Sites.FullControl.All |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-GET /sites/{siteId}/contentTypes/{contentTypeId}/isPublished
-```
->**Note:** The siteId represents a content type hub site.
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Response
-If successful, this call returns a `200 OK` response and a boolean value specifying the publishing state of the content type.
-
-## Request body
-Do not supply a request body for this method.
-
-## Example
-
-### Request
-<!-- {
- "blockType": "request",
- "name": "contenttype_ispublished"
-}
>
-```http
-GET https://graph.microsoft.com/beta/sites/{siteId}/contentTypes/{contentTypeId}/isPublished
-```
-### Response
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "string"
-}
>-
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "value": true
-}
-```
-
-[contentType]: ../resources/contentType.md
v1.0 Contenttype List Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-list-columns.md
-- Title: "List columnDefinitions"
-description: "List columns in a content type."
-localization_priority: Normal
-doc_type: apiPageType
--
-# List columnDefinitions
-Namespace: microsoft.graph
-
-Get the collection of [columns][columnDefinition] in a [content type][contentType].
-
-
-
-## Permissions
-
-
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-
-
-## HTTP request
-
-
-<!-- {
- "blockType": "ignored"
-}
>
-```http
-
-GET /sites/{site-id}/contentTypes/{contentType-id}/columns
-GET /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}/columns
-```
-
-
-## Optional query parameters
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [columnDefinition][] objects in the response body.
-
-
-
-## Example
-
-### Request
-
-<!-- { "blockType": "request", "name": "get_columns_from_contenttype" } -->
-
-
-```http
-GET https://graph.microsoft.com/beta/sites/{site-id}/contentTypes/{contentType-id}/columns
-```
-
-### Response
->**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.columnDefinition)"
-}
> -
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "value": [
- {
- "description": "",
- "displayName": "Title",
- "hidden": false,
- "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103",
- "indexed": false,
- "name": "Title",
- "readOnly": false,
- "required": false,
- "text": {
- "allowMultipleLines": false,
- "appendChangesToExistingText": false,
- "linesForEditing": 0,
- "maxLength": 255
- }
- },
- {
- "description": "",
- "displayName": "Address",
- "id": "11dfef35-e2f7-4f17-82b0-6fba34445103",
- "indexed": false,
- "name": "Address",
- "readOnly": false,
- "required": false,
- "text": {
- "allowMultipleLines": false,
- "appendChangesToExistingText": false,
- "linesForEditing": 0,
- "maxLength": 255
- }
- }
- ]
-}
-```
-
-
-
-[columnDefinition]: ../resources/columnDefinition.md
-[contentType]: ../resources/contentType.md
-
v1.0 Contenttype List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-list.md
-- Title: "List contentTypes"
-description: "List content types in a site or a list"
-localization_priority: Normal
-doc_type: apiPageType
--
-# List contentTypes
-Namespace: microsoft.graph
-
-Get the collection of [content types][contentType] in a [site][] or a [list][]
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-## HTTP request
-<!-- {
- "blockType": "ignored"
-}
>
-```http
-GET /sites/{site-id}/contentTypes
-GET /sites/{site-id}/lists/{list-id}/contentTypes
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [contentType](../resources/contenttype.md) objects in the response body.
-
-## Example
-
-### Request
-
-<!-- { "blockType": "request", "name": "enum_contentTypes"} -->
-
-```http
-GET https://graph.microsoft.com/beta/sites/{site-id}/contentTypes
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.contentType)"
-}
>-
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "value": [
- {
- "id":"0x",
- "description":"",
- "group":"_Hidden",
- "hidden":false,
- "name":"System",
- "base": {
- "name": "System",
- "id": "0x"
- }
- },
- {
- "id":"0x00A7470EADF4194E2E9ED1031B61DA0884",
- "name": "docSet",
- "description": "custom docset",
- "hidden":false,
- "base": {
- "name": "Document Set",
- "id": "0x0120D520"
- },
- "group": "Custom Content Types"
- }
- ]
-}
-```
--
-[contentType]: ../resources/contentType.md
-[site]: ../resources/site.md
-[list]: ../resources/list.md
v1.0 Contenttype Post Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-post-columns.md
-- Previously updated : 08/30/2020 Title: "Create columnDefinition"
-description: "Add column to a content type."
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create columnDefinition
-Namespace: microsoft.graph
-
-Adds existing site or list [column][columnDefinition] to a [content type][contentType].
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/concepts/permissions_reference.md).
-
-
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-```http
-POST /sites/{site-id}/contentTypes/{contentType-id}/columns
-POST /sites/{site-id}/lists/{list-id}//contentTypes/{contentType-id}/columns
-```
-
-## Request body
-
-In the request body, supply a JSON representation of the [columnDefinition][] resource to add.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and [contentType][] object in the response body.
-
-## Example
-
-### Request
-<!-- { "blockType": "request" } -->
-```http
-POST https://graph.microsoft.com/beta/sites/{site-id}/contentTypes/{contentType-id}/columns
-Content-Type: application/json
-
-{
- "sourceColumn@odata.bind": "https://graph.microsoft.com/beta/sites/root/columns/99ddcf45-e2f7-4f17-82b0-6fba34445103",
-}
-```
-
-### Response
-
-The response returns a list of all columns added to a content type.
-
-<!-- { "blockType": "response", "@type": "microsoft.graph.columnDefinition", "truncated": true, "scopes": "sites.readwrite.all" } -->
-
-
-
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "description": "",
- "displayName": "Title",
- "enforceUniqueValues": false,
- "hidden": false,
- "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103",
- "indexed": false,
- "name": "Title",
- "text": {
- "allowMultipleLines": false,
- "appendChangesToExistingText": false,
- "linesForEditing": 0,
- "maxLength": 255
- }
-}
-
-```
-
-
-
-[columnDefinition]: ../resources/columnDefinition.md
-[contentType]: ../resources/contentType.md
-
-
v1.0 Contenttype Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-post.md
-- Title: "Create contentType"
-description: "Create a Content type in a site."
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create contentType
-Namespace: microsoft.graph
--
-Create a new [contentType][] in a [site][].
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) |Not Supported |
-|Application | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
--
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-POST /sites/{site-id}/contentTypes
-
-```
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply a JSON representation of the [contentType][] resource to create.
-
-## Response
-
-If successful, this method returns a `201 Created` response code and a [contentType][] object in the response body.
--
-## Example
-
-The following example shows how to create a new generic content type.
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "create_contenttype"
-}
>-
-```http
-POST https://graph.microsoft.com/beta/sites/{id}/contentTypes
-Content-Type: application/json
-
-{
- "name": "docSet",
- "description": "custom docset",
- "parentReference": {
- name: "Document Set",
- id: "0x0120D520"
- },
- "group": "Document Set Content Types"
-}
-```
-
-### Response
->**Note:** The response object shown here might be shortened for readability.
-
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.contentType"
-}
>-
-```http
-HTTP/1.1 201 Created
-Content-type: application/json
-
-{
- "id": "0x01002A2479FF33DD4BC3B1533A012B653717",
- "name": "docSet",
- "group":"Document Set Content Types",
- "description" : "custom docset",
- "base": {
- "name": "Document Set",
- "id": "0x0120D520"
- }
-}
-```
--
-[contentType]: ../resources/contentType.md
-[site]: ../resources/site.md
-
-<!--
-{
- "type": "#page.annotation",
- "description": "Create a Content type in a site",
- "keywords": "content type",
- "section": "documentation",
- "tocPath": "sites/Create ContentType",
- "suppressions": [
- ]
-}
>
v1.0 Contenttype Publish https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-publish.md
-- Title: "contentType: publish"
-description: "Publish a content type present in content type hub site."
-localization_priority: Normal
-doc_type: apiPageType
--
-# contentType: publish
-Namespace: microsoft.graph
-
-Publishes a [contentType][] present in content type hub site.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Sites.FullControl.All |
-|Application | Sites.FullControl.All |
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>
-```http
-POST /sites/{siteId}/contentTypes/{contentTypeId}/publish
-```
-
->**Note:** The siteId represents a content type hub site.
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this call returns a `204 No Content` response.
-
-## Example
-
-### Request
-<!-- {
- "blockType": "request",
- "name": "contenttype_publish"
-}
>
-```http
-POST https://graph.microsoft.com/beta/sites/{siteId}/contentTypes/{contentTypeId}/publish
-```
-
-### Response
-
-<!-- { "blockType": "response" } -->
-
-```http
-HTTP/1.1 204 No Content
-```
-
-[contentType]: ../resources/contentType.md
v1.0 Contenttype Unpublish https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-unpublish.md
-- Title: "contentType: unpublish"
-description: "Unpublish a content type from a content type hub site."
-localization_priority: Normal
-doc_type: apiPageType
--
-# contentType: unpublish
-Namespace: microsoft.graph
-
-Unpublish a [contentType][] from a content type hub site.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Sites.FullControl.All |
-|Application | Sites.FullControl.All |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-POST /sites/{siteId}/contentTypes/{contentTypeId}/unpublish
-```
-
->**Note:** The siteId represents a content type hub site.
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `204 No Content` response.
-
-## Example
-
-### Request
-<!-- {
- "blockType": "request",
- "name": "contenttype_unpublish"
-}
>
-```http
-POST https://graph.microsoft.com/beta/sites/{siteId}/contentTypes/{contentTypeId}/unpublish
-```
-
-### Response
-
-<!-- { "blockType": "response" } -->
-
-```http
-HTTP/1.1 204 No Content
-```
-
-[contentType]: ../resources/contentType.md
v1.0 Contenttype Update Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-update-columns.md
-- Title: "Update columnDefinition"
-description: "Update a content type column"
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update columnDefinition
-Namespace: microsoft.graph
-
-Update a [content type][contentType] [column][columnDefinition].
-
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-```http
-PATCH /sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
-PATCH /sites/{site-id}/lists/{list-id}//contentTypes/{contentType-id}/columns/{column-id}
-```
--
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
--
-## Request body
-
-In the request body, supply a JSON representation of the [columnDefinition][] resource to update.
-
->**Note:** Only required and hidden properties can be updated.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and an updated [columnDefinition][] object in the response body.
-
-## Example
-
-### Request
-<!-- {
- "blockType": "request",
- "name": "update_contenttype_column"
-}
>
-```http
-PATCH /sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
-Content-Type: application/json
-
-{
- "required": true,
- "hidden": false,
- "propagateChanges": false
-}
-```
-
-### Response
->**Note:** The response object shown here might be shortened for readability.
-
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.columnDefinition"
-}
>
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "description": "",
- "displayName": "Custom Column",
- "enforceUniqueValues": false,
- "hidden": false,
- "id": "11dfef35-e2f7-4f17-82b0-6fba34445103",
- "indexed": false,
- "name": "Custom Column",
- "readOnly": false,
- "required": true,
- "text": {
- "allowMultipleLines": false,
- "appendChangesToExistingText": false,
- "linesForEditing": 0,
- "maxLength": 255
- }
-}
-
-```
-
-
-
-[columnDefinition]: ../resources/columnDefinition.md
-[contentType]: ../resources/contentType.md
v1.0 Contenttype Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-update.md
-- Title: "Update contentType"
-description: "Update a content type"
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update contentType
-Namespace: microsoft.graph
-
-Update a [content type][contentType].
-
-
-## Permissions
-
-
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
-
-
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application |Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
-
-
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>
-```http
-PATCH /sites/{site-id}/contentTypes/{contentType-id}
-PATCH /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}
-```
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply a JSON representation of the [contentType][] resource to update.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and an updated [contentType][] object in the response body.
-
-## Example
-
-### Request
-<!-- {
- "blockType": "request",
- "name": "update_contenttype"
-}
>-
-```http
-PATCH https://graph.microsoft.com/beta/sites/{site-id}/contentTypes/{contentType-id}
-Content-Type: application/json
-
-{
- "name": "updatedCt",
- "documentSet": {
- "shouldPrefixNameToFile": true,
- "allowedContentTypes": [{
- "id": "0x0101",
- "name": "Document"
- }],
- "defaultContents": [{
- "fileName": "a.txt",
- "contentType": {
- "id": "0x0101"
- }
- },
- {
- "fileName": "b.txt",
- "contentType": {
- "id": "0x0101"
- }
- }
- ],
- "sharedColumns": [{
- "name": "Description",
- "id": "cbb92da4-fd46-4c7d-af6c-3128c2a5576e"
- },
- {
- "name": "Address",
- "id": "fc2e188e-ba91-48c9-9dd3-16431afddd50"
- }
- ],
- "welcomePageColumns": [{
- "name": "Address",
- "id": "fc2e188e-ba91-48c9-9dd3-16431afddd50"
- }]
- }
-}
-
-```
-
-### Response
-
-<!-- { "blockType": "response", "@type": "microsoft.graph.contentType", "truncated": true} -->
-
-
-
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "id": "0x0101009B237E76EF94DC49B4E58139041E7C60",
- "description": "",
- "eTag": "\"7\"",
- "group": "Custom Content Types",
- "hidden": false,
- "name": "testdoc",
- "parentId": "0x0101",
- "base": {
- "id": "0x0101",
- "name": "Document"
- }
-}
-
-```
-
-[contentType]: ../resources/contentType.md
v1.0 Continuousaccessevaluationpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/continuousaccessevaluationpolicy-get.md
Title: "Get continuousAccessEvaluationPolicy"
description: "Read the properties of a continuousAccessEvaluationPolicy object." localization_priority: Normal doc_type: apiPageType
v1.0 Continuousaccessevaluationpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/continuousaccessevaluationpolicy-update.md
Title: "Update continuousAccessEvaluationPolicy"
description: "Update the properties of a continuousAccessEvaluationPolicy object." localization_priority: Normal doc_type: apiPageType
v1.0 Contract Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contract-get.md
Title: "Get Contract"
description: "Retrieve the properties and relationships of contract object." localization_priority: Normal doc_type: apiPageType
v1.0 Contract List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contract-list.md
Title: "List contracts"
description: "Retrieve a list of contract objects associated to a partner tenant." localization_priority: Normal doc_type: apiPageType
v1.0 Countrynamedlocation Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/countrynamedlocation-delete.md
Title: "Delete countryNamedLocation"
description: "Delete a countryNamedLocation object." localization_priority: Normal doc_type: apiPageType
v1.0 Countrynamedlocation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/countrynamedlocation-get.md
Title: "Get countryNamedLocation"
description: "Retrieve the properties and relationships of a countryNamedlocation object." localization_priority: Normal doc_type: apiPageType
v1.0 Countrynamedlocation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/countrynamedlocation-update.md
Title: "Update countryNamedlocation"
description: "Update the properties of a countryNamedLocation object." localization_priority: Normal doc_type: apiPageType
v1.0 Custodian Activate https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/custodian-activate.md
+
+ Title: "custodian: activate"
+description: "Reactivate a custodian in a case."
+
+localization_priority: Normal
++
+# custodian: activate
+
+Namespace: microsoft.graph
++
+Activate a custodian that has been released from a case to make them part of the case again. For details, see [Manage custodians in an Advanced eDiscovery case](/microsoft-365/compliance/manage-new-custodians#re-activate-custodian).
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST /compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}/activate
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "custodian_activate"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/2192ca408ea2410eba3bec8ae873be6b/custodians/45454331323337443946343043464239/activate
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Custodian Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/custodian-get.md
+
+ Title: "Get custodian"
+description: "Read the properties and relationships of a custodian object."
+
+localization_priority: Normal
++
+# Get custodian
+
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [custodian](../resources/custodian.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [custodian](../resources/custodian.md) object in the response body.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_custodian"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/2192ca408ea2410eba3bec8ae873be6b/custodians/45454331323337443946343043464239
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.custodian"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('4c8f8f70-7785-4bd4-b296-c98376a2c5e1')/custodians/$entity",
+ "email": "AdeleV@contoso.com",
+ "applyHoldToSources": true,
+ "status": "active",
+ "createdDateTime": "2020-10-30T20:59:54.9900703Z",
+ "lastModifiedDateTime": "2020-10-30T20:59:55.1400013Z",
+ "releasedDateTime": null,
+ "acknowledgedDateTime": null,
+ "id": "45454331323337443946343043464239",
+ "displayName": "Adele Vance"
+}
+```
v1.0 Custodian List Sitesources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/custodian-list-sitesources.md
+
+ Title: "List siteSources"
+description: "Get a list of the siteSource objects and their properties."
+
+localization_priority: Normal
++
+# List siteSources
+
+Namespace: microsoft.graph
++
+Get a list of [siteSource](../resources/sitesource.md) objects and their properties.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}/siteSources
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [siteSource](../resources/sitesource.md) objects in the response body.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_sitesource"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/2192ca408ea2410eba3bec8ae873be6b/siteSources
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.siteSource)"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('4c8f8f70-7785-4bd4-b296-c98376a2c5e1')/custodians('2192ca408ea2410eba3bec8ae873be6b')/siteSources",
+ "value": [
+ {
+ "displayName": "Microsoft Team Site",
+ "createdDateTime": "2020-10-27T15:14:11.0048392Z",
+ "id": "38304445-3741-3333-4233-344238454333",
+ "createdBy": {
+ "user": {
+ "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
+ "displayName": null
+ }
+ }
+ }
+ ]
+}
+```
v1.0 Custodian List Unifiedgroupsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/custodian-list-unifiedgroupsources.md
+
+ Title: "List unifiedGroupSources"
+description: "Get a list of the unifiedGroupSource objects and their properties."
+
+localization_priority: Normal
++
+# List unifiedGroupSources
+
+Namespace: microsoft.graph
++
+Get a list of the [unifiedGroupSource](../resources/unifiedgroupsource.md) objects and their properties.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}/unifiedGroupSources
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [unifiedGroupSource](../resources/unifiedgroupsource.md) objects in the response body.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_unifiedgroupsource"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/2192ca408ea2410eba3bec8ae873be6b/unifiedGroupSources
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.unifiedGroupSource)"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('4c8f8f70-7785-4bd4-b296-c98376a2c5e1')/custodians('2192ca408ea2410eba3bec8ae873be6b')/unifiedGroupSources",
+ "value": [
+ {
+ "displayName": "Developers group",
+ "createdDateTime": "2020-10-27T15:14:11.0048392Z",
+ "id": "33434233-3030-3739-3043-393039324633",
+ "includedSources": "mailbox,site",
+ "createdBy": {
+ "user": {
+ "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
+ "displayName": "Megan Bowen"
+ }
+ }
+ }
+ ]
+}
+```
v1.0 Custodian List Usersources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/custodian-list-usersources.md
+
+ Title: "List userSources"
+description: "Get a list of the userSource objects and their properties."
+
+localization_priority: Normal
++
+# List userSources
+
+Namespace: microsoft.graph
++
+Get a list of the [userSource](../resources/usersource.md) objects and their properties.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}/userSources
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [userSource](../resources/usersource.md) objects in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_usersource"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/2192ca408ea2410eba3bec8ae873be6b/userSources
+```
+
+### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.userSource)"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('4c8f8f70-7785-4bd4-b296-c98376a2c5e1')/custodians('2192ca408ea2410eba3bec8ae873be6b')/userSources",
+ "value": [
+ {
+ "displayName": "Megan Bowen",
+ "createdDateTime": "2020-08-21T13:20:01.3430206Z",
+ "id": "46384443-4137-3032-3437-363939433735",
+ "email": "megan@contoso.com",
+ "includedSources": "mailbox,site",
+ "createdBy": {
+ "user": {
+ "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
+ "displayName": "Adele Vance"
+ }
+ }
+ }
+ ]
+}
+```
v1.0 Custodian Post Sitesources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/custodian-post-sitesources.md
+
+ Title: "Create siteSource"
+description: "Create a new siteSource object."
+
+localization_priority: Normal
++
+# Create siteSource
+
+Namespace: microsoft.graph
++
+Create a new [siteSource](../resources/sitesource.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST /compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}/siteSources
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the [siteSource](../resources/sitesource.md) object.
+
+The following table shows the properties that are required when you create the [siteSource](../resources/sitesource.md).
+
+|Property|Type|Description|
+|:|:|:|
+|site@odata.bind|String|ID of the site, which you can get from the [site](../resources/site.md) resource by using the [Get a site resource by path](../api/site-getbypath.md) method. The usage is {hostname}:/{relative-path}. For the site URL `https://contoso.sharepoint.com/sites/HumanResources`, the Microsoft Graph request would be `https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/HumanResources`. The ID is the first GUID listed in the ID field.|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [siteSource](../resources/sitesource.md) object in the response body.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_sitesource_from_"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/2192ca408ea2410eba3bec8ae873be6b/siteSources
+Content-Type: application/json
+Content-length: 179
+
+{
+ "site@odata.bind": "https://graph.microsoft.com/v1.0/sites/{siteId}"
+}
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.siteSource"
+}
+-->
+
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('4c8f8f70-7785-4bd4-b296-c98376a2c5e1')/custodians('2192ca408ea2410eba3bec8ae873be6b')/siteSources",
+ "value": [
+ {
+ "displayName": "Human resources site",
+ "createdDateTime": "2020-10-27T15:14:11.0048392Z",
+ "id": "38304445-3741-3333-4233-344238454333",
+ "createdBy": {
+ "user": {
+ "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
+ "displayName": null
+ }
+ }
+ }
+ ]
+}
+```
v1.0 Custodian Post Unifiedgroupsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/custodian-post-unifiedgroupsources.md
+
+ Title: "Create unifiedGroupSource"
+description: "Create a new unifiedGroupSource object."
+
+localization_priority: Normal
++
+# Create unifiedGroupSource
+
+Namespace: microsoft.graph
++
+Create a new [unifiedGroupSource](../resources/unifiedgroupsource.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST /compliance/ediscovery/cases/4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/2192ca408ea2410eba3bec8ae873be6b/unifiedGroupSources
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the [unifiedGroupSource](../resources/unifiedgroupsource.md) object.
+
+The following table shows the properties that are required when you create the [unifiedGroupSource](../resources/unifiedgroupsource.md).
+
+|Property|Type|Description|
+|:|:|:|
+|includedSources|sourceType|Specifies which sources are included in this group. Possible values are: `mailbox`, `site`.|
+|group@odata.bind|String|ID of the group. To get the group ID, use the [List groups](../api/group-list.md) operation.|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [unifiedGroupSource](../resources/unifiedgroupsource.md) object in the response body.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_unifiedgroupsource_from_"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}/unifiedGroupSources
+Content-Type: application/json
+Content-length: 219
+
+{
+ "group@odata.bind": "/groups/000044f9-47c8-4a87-bccf-291fbf006a54",
+ "includedSources": "mailbox, site"
+}
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.unifiedGroupSource"
+}
+-->
+
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "group@odata.bind": "/groups/000044f9-47c8-4a87-bccf-291fbf006a54",
+ "includedSources": "mailbox, site",
+ "id": "14202dd90a1f4ccc84929586326c7104",
+ "displayName": "SFA Videos",
+ "createdDateTime": "2020-03-13T22:38:00.8985662Z",
+ "createdBy": {
+ "user": {
+ "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
+ "displayName": "Megan Bowen"
+ }
+ }
+}
+```
v1.0 Custodian Post Usersources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/custodian-post-usersources.md
+
+ Title: "Create userSource"
+description: "Create a new userSource object."
+
+localization_priority: Normal
++
+# Create userSource
+
+Namespace: microsoft.graph
++
+Create a new [userSource](../resources/usersource.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST /compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}/userSources
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the [userSource](../resources/usersource.md) object.
+
+The following table shows the properties that are required when you create the [userSource](../resources/usersource.md).
+
+|Property|Type|Description|
+|:|:|:|
+|email|String|SMTP address of the user.|
+|includedSources|sourceType|Specifies which sources are included in this group. Possible values are: `mailbox`, `site`.|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [userSource](../resources/usersource.md) object in the response body.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_usersource_from_"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/2192ca408ea2410eba3bec8ae873be6b/userSources
+Content-Type: application/json
+Content-length: 233
+
+{
+ "email":"megan@contoso.com",
+ "includedSources":"mailbox, site"
+}
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.userSource"
+}
+-->
+
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('4c8f8f70-7785-4bd4-b296-c98376a2c5e1')/custodians('45454331323337443946343043464239')/userSources/$entity",
+ "displayName": "Megan Bowen",
+ "createdDateTime": "2020-11-06T16:09:08.4905571Z",
+ "id": "34383036-3741-4545-3242-373530353435",
+ "email": "megan@contoso.com",
+ "includedSources": "mailbox,site",
+ "createdBy": {
+ "user": {
+ "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
+ "displayName": null
+ }
+ }
+}
+```
v1.0 Custodian Release https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/custodian-release.md
+
+ Title: "custodian: release"
+description: "Release a custodian from a case."
+
+localization_priority: Normal
++
+# custodian: release
+
+Namespace: microsoft.graph
++
+Release a custodian from a case. For details, see [Release a custodian from a case](/microsoft-365/compliance/manage-new-custodians#release-a-custodian-from-a-case).
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST /compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}/release
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "custodian_release"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/2192ca408ea2410eba3bec8ae873be6b/custodians/45454331323337443946343043464239/release
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Custodian Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/custodian-update.md
+
+ Title: "Update custodian"
+description: "Update the properties of a custodian object."
+
+localization_priority: Normal
++
+# Update custodian
+
+Namespace: microsoft.graph
++
+Update the properties of a [custodian](../resources/custodian.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+PATCH /compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the [custodian](../resources/custodian.md) object.
+
+The following table lists the properties of a [custodian](../resources/custodian.md) object that can be modified.
+
+|Property|Type|Description|
+|:|:|:|
+|applyHoldToSources|Boolean|Identifies whether a custodian's sources were placed on hold during creation. For details, see [Place custodians on hold](/microsoft-365/compliance/add-custodians-to-case#step-4-place-custodians-on-hold).|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [custodian](../resources/custodian.md) object in the response body.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_custodian"
+}
+-->
+
+``` http
+PATCH https://graph.microsoft.com/beta/compliance/ediscovery/cases/2192ca408ea2410eba3bec8ae873be6b/custodians/45454331323337443946343043464239
+Content-Type: application/json
+Content-length: 254
+
+{
+ "applyHoldToSources": "false",
+}
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.custodian"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases/4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/$entity",
+ "email": "AdeleV@contoso.com",
+ "applyHoldToSources": false,
+ "status": "active",
+ "createdDateTime": "2020-10-30T20:59:54.9900703Z",
+ "lastModifiedDateTime": "2020-10-30T21:01:34.1400013Z",
+ "releasedDateTime": null,
+ "acknowledgedDateTime": null,
+ "id": "45454331323337443946343043464239",
+ "displayName": "Adele Vance"
+}
+```
v1.0 Datapolicyoperation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/datapolicyoperation-get.md
Title: "Get dataPolicyOperation"
description: "Retrieve the properties of the dataPolicyOperation object." localization_priority: Normal doc_type: apiPageType
v1.0 Device Checkmemberobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-checkmemberobjects.md
Title: "device: checkMemberObjects"
description: "Check for membership in a list of groups, directory roles, or administrative units for the specified device object." localization_priority: Normal doc_type: "apiPageType"
v1.0 Device Delete Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-delete-registeredowners.md
Title: "Delete registeredowners"
description: "Remove a user as a registered owner of the device." localization_priority: Normal doc_type: apiPageType
v1.0 Device Delete Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-delete-registeredusers.md
Title: "Delete registeredUsers"
description: "Remove a user as a registered user of the device." localization_priority: Normal doc_type: apiPageType
v1.0 Device Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-delete.md
Title: "Delete device"
description: "Delete a registered device." localization_priority: Normal doc_type: apiPageType
v1.0 Device Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-get.md
Title: "Get device"
description: "Get the properties and relationships of a device object." localization_priority: Normal doc_type: apiPageType
v1.0 Device List Memberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-list-memberof.md
Title: "List device groups"
description: "Get groups that this device is a direct member of. This operation is not transitive." localization_priority: Normal doc_type: apiPageType
v1.0 Device List Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-list-registeredowners.md
Title: "List registeredOwners"
description: "Retrieve a list of users that are registered owners of the device." localization_priority: Normal doc_type: apiPageType
v1.0 Device List Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-list-registeredusers.md
Title: "List registeredUsers"
description: "Retrieve a list of users that are registered users of the device." localization_priority: Normal doc_type: apiPageType
v1.0 Device List Transitivememberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-list-transitivememberof.md
Title: "List device transitive groups"
description: "Get groups that the device is a member of." localization_priority: Normal doc_type: apiPageType
v1.0 Device List Usagerights https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-list-usagerights.md
Title: "List device usageRights"
description: "Retrieve a list of usageRights objects for a device." localization_priority: Normal doc_type: apiPageType
v1.0 Device List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-list.md
Title: "List devices"
description: "Retrieve a list of devices registered in the directory. " localization_priority: Normal doc_type: apiPageType
v1.0 Device Post Devices https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-post-devices.md
Title: "Create device"
description: "Create a new device." localization_priority: Normal doc_type: apiPageType
v1.0 Device Post Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-post-registeredowners.md
Title: "Create registeredOwner"
description: "Add a user as a registered owner of the device." localization_priority: Normal doc_type: apiPageType
v1.0 Device Post Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-post-registeredusers.md
Title: "Create registeredUser"
description: "Add a registered user for the device." localization_priority: Normal doc_type: apiPageType
v1.0 Device Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-update.md
Title: "Update device"
description: "Update the properties of a device." localization_priority: Normal doc_type: apiPageType
v1.0 Directory Deleteditems Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directory-deleteditems-delete.md
Title: "Permanently delete item"
description: "Permanently delete an item from deleted items." localization_priority: Normal doc_type: apiPageType
For users:
|:--|:| |Delegated (work or school account) | User.ReadWrite.All, Directory.AccessAsUser.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | User.ReadWrite.All |
For groups:
For groups:
|:--|:| |Delegated (work or school account) | Group.ReadWrite.All, Directory.AccessAsUser.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | Group.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Directory Deleteditems Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directory-deleteditems-get.md
Title: "Get deleted item"
description: "Retrieve the properties of a recently deleted item in deleted items." localization_priority: Normal doc_type: apiPageType
v1.0 Directory Deleteditems List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directory-deleteditems-list.md
Title: "List deleted items"
description: "Retrieve a list of recently deleted items from deleted items." localization_priority: Normal doc_type: apiPageType
v1.0 Directory Deleteditems Restore https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directory-deleteditems-restore.md
Title: "Restore deleted item"
description: "Restores a recently deleted item from deleted items. " localization_priority: Normal doc_type: apiPageType
Namespace: microsoft.graph
Restores a recently deleted item from [deleted items](../resources/directory.md).
-Currently, restore deleted items functionality is only supported for the [application](../resources/application.md), [group](../resources/group.md), and [user](../resources/user.md) resources. If an item was accidentally deleted, you can fully restore the item. This is not applicable to Security groups which are deleted permanently.
+Currently, deleted items functionality is only supported for the [application](../resources/application.md), [group](../resources/group.md) and [user](../resources/user.md) resources. If an item was accidentally deleted, you can fully restore the item.
A recently deleted item will remain available for up to 30 days. After 30 days, the item is permanently deleted.
v1.0 Directory Deleteditems User Owned https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directory-deleteditems-user-owned.md
Title: "List deleted items owned by a user"
description: "Retrieves a list of recently deleted items owned by the specified user. " localization_priority: Normal doc_type: apiPageType
Content-length: 1249
} ] }
-```
+```
v1.0 Directory List Featurerolloutpolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directory-list-featurerolloutpolicies.md
Title: "List featureRolloutPolicies"
description: "Retrieve a list of featureRolloutPolicy objects." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | |:|:--|
-| Delegated (work or school account) | Directory.ReadWrite.All |
+| Delegated (work or school account) | Policy.Read.All |
| Delegated (personal Microsoft account) | Not supported. | | Application | Not supported. |
v1.0 Directory Post Featurerolloutpolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directory-post-featurerolloutpolicies.md
Title: "Create featureRolloutPolicy"
description: "Create a new featureRolloutPolicy object." localization_priority: Normal doc_type: "apiPageType"
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | |:|:--|
-| Delegated (work or school account) | Directory.ReadWrite.All |
+| Delegated (work or school account) | Policy.ReadWrite.FeatureRollout |
| Delegated (personal Microsoft account) | Not supported. | | Application | Not supported. |
v1.0 Directoryaudit Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryaudit-get.md
Title: "Get directoryAudit"
description: "Describes the get method of the directoryAudit resource (entity) from the Microsoft Graph API (beta version)." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryaudit List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryaudit-list.md
Title: "List directoryAudits"
description: "Describes the list method of the directoryAudit resource (entity) from the Microsoft Graph API (beta version)." localization_priority: Normal doc_type: apiPageType
v1.0 Directorydefinition Discover https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorydefinition-discover.md
Title: "directoryDefinition: discover"
description: "Discover the latest schema definition for provisioning to an application. " localization_priority: Normal doc_type: "apiPageType"
Discover the latest schema definition for provisioning to an application.
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported.|
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | Directory.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application-only | None. |
## HTTP request
v1.0 Directoryobject Checkmembergroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryobject-checkmembergroups.md
Title: "Check member groups"
description: "Check for membership in a specified list of groups, and returns from that list those groups" localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | User.ReadBasic.All, User.Read.All, Directory.Read.All |
+|Delegated (work or school account) | User.ReadBasic.All and GroupMember.Read.All, User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All |
|Delegated (personal Microsoft account) | Not supported. |
-|Application | User.Read.All, Directory.Read.All |
+|Application | User.Read.All and GroupMember.Read.All, User.Read.All and Group.Read.All, Directory.Read.All |
Use the follow scenario guidance to help determine which permission types to use: - Use User.Read and GroupMember.Read.All or User.Read and Group.Read.All permissions to get group memberships for the signed-in user.
v1.0 Directoryobject Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryobject-delete.md
Title: "Delete directoryObject"
description: "Delete directoryObject." localization_priority: Normal doc_type: apiPageType
Here is an example of the request.
"name": "delete_directoryobject" }--> ```http
-DELETE https://graph.microsoft.com/beta/directoryObjects/ffab4dce-9b82-49a6-b7c7-1a143106598c
+DELETE https://graph.microsoft.com/beta/directoryObject/ffab4dce-9b82-49a6-b7c7-1a143106598c
``` ##### Response Here is an example of the response.
v1.0 Directoryobject Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryobject-delta.md
Title: "directoryObject: delta"
description: "Get newly created, updated, or deleted directory objects of the following types: user, group and organizational contact, in a single delta query. See Track changes for details." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryobject Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryobject-get.md
Title: "Get directoryObject"
description: "Retrieve the properties and relationships of directoryobject object." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryobject Getbyids https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryobject-getbyids.md
Title: "directoryObject: getByIds"
description: "Returns the directory objects specified in a list of IDs. " localization_priority: Normal doc_type: apiPageType
v1.0 Directoryobject Getmembergroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryobject-getmembergroups.md
Title: "Get member groups"
description: "Return all the groups that the specified user, group, service principal or directory object is a member of. This function is transitive." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryobject Getmemberobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryobject-getmemberobjects.md
Title: "Get member objects"
description: " Returns all the groups, administrative units and directory roles that a user, group, service principals or directory object is a member of. This function is transitive. " localization_priority: Normal doc_type: apiPageType
v1.0 Directoryobject Validateproperties https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryobject-validateproperties.md
Title: "directoryObject: validateProperties"
description: "Validate that a Microsoft 365 group's display name or mail nickname complies with naming policies." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryrole Delete Member https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryrole-delete-member.md
Title: "Remove directory role member"
description: "Remove a member from a directoryRole." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryrole Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryrole-delta.md
Title: "directoryRole: delta"
description: "Get newly created, updated, or deleted directory roles without having to perform a full read of the entire resource collection. See Using Delta Query for details." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryrole Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryrole-get.md
Title: "Get directoryRole"
description: "Retrieve the properties of a directoryRole object." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryrole List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryrole-list-members.md
Title: "List members"
description: "Retrieve a list of the users that are assigned to the directory role. Only users can be assigned to a directory role." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryrole List Scopedadministrators https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryrole-list-scopedadministrators.md
Title: "List scopedMembers for a directory role"
description: "Retrieve a list of scopedRoleMembership objects for a directory role." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryrole List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryrole-list.md
Title: "List directoryRoles"
description: "List the directory roles that are activated in the tenant." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryrole Post Directoryroles https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryrole-post-directoryroles.md
Title: "Activate directoryRole"
description: "Activate a directory role." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryrole Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryrole-post-members.md
Title: "Add directory role member"
description: "Create a new directory role member." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryroletemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryroletemplate-get.md
Title: "Get directoryRoleTemplate"
description: "Retrieve the properties and relationships of a directoryroletemplate object." localization_priority: Normal doc_type: apiPageType
v1.0 Directoryroletemplate List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryroletemplate-list.md
Title: "List directoryRoleTemplates"
description: "Retrieve a list of directoryroletemplate objects." localization_priority: Normal doc_type: apiPageType
v1.0 Directorysetting Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysetting-delete.md
Title: "Delete a directory setting"
description: "Delete a directory setting." localization_priority: Normal doc_type: apiPageType
v1.0 Directorysetting Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysetting-get.md
Title: "Get a directory setting"
description: "Retrieve the properties of a specific directory setting object." localization_priority: Normal doc_type: apiPageType
v1.0 Directorysetting List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysetting-list.md
Title: "List directory settings"
description: "Retrieve a list of directory setting objects." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
List tenant-wide or group settings ```http GET /settings
-GET /groups/{id}/settings
+GET /group/{id}/settings
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Directorysetting Post Settings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysetting-post-settings.md
Title: "Create a directory setting"
description: "Use this API to create a new setting, based on the templates available in directorySettingTemplates." localization_priority: Normal doc_type: apiPageType
v1.0 Directorysetting Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysetting-update.md
Title: "Update a directory setting"
description: "Update the properties of a specific directory setting object." localization_priority: Normal doc_type: apiPageType
v1.0 Directorysettingtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysettingtemplate-get.md
Title: "Get a directory setting template"
description: "Allows retrieval of the properties of the directorySettingTemplate object, including the available settings and their defaults." localization_priority: Normal doc_type: apiPageType
v1.0 Directorysettingtemplate List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysettingtemplate-list.md
Title: "List directorySettingTemplates"
description: "This operation retrieves the list of available directorySettingTemplates objects." localization_priority: Normal doc_type: apiPageType
v1.0 Domain Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/domain-delete.md
Title: "Delete domain"
description: "Deletes a domain from a tenant." localization_priority: Normal doc_type: apiPageType
v1.0 Domain Forcedelete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/domain-forcedelete.md
Title: "domain: forceDelete"
description: "Deletes a domain using an asynchronous operation." localization_priority: Normal doc_type: apiPageType
Namespace: microsoft.graph
Deletes a domain using an asynchronous operation.
-Prior to calling [forceDelete](domain-forcedelete.md), you must update or remove any references to **Exchange** as the provisioning service.
- The following actions are performed as part of this operation: * Renames the UPN, EmailAddress, and ProxyAddress of users with references to the deleted domain.
The following actions are performed as part of this operation:
* Renames the identifierUris of applications with references to the deleted domain.
-* If the number of objects to be renamed is greater than 1,000, an error is returned.
+* If the number of objects to be renamed is greater than 1000, an error is returned.
* If one of the applications to be renamed is a multi-tenant app, an error is returned.
In the request body, provide a JSON object with the following parameters.
If successful, this method returns `200 OK` response code. ## Example
-### Request
+##### Request
# [HTTP](#tab/http) <!-- {
Content-length: 33
-### Response
+##### Response
<!-- { "blockType": "response",
v1.0 Domain Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/domain-get.md
Title: "Get domain"
description: "Retrieve the properties and relationships of domain object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Directory.Read.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Domain.Read.All, Domain.ReadWrite.All, Directory.Read.All |
+|Application | Directory.Read.All, Domain.ReadWrite.All |
## HTTP request
v1.0 Domain List Domainnamereferences https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/domain-list-domainnamereferences.md
Title: "List domainNameReferences"
description: "Retrieve a list of directoryObject with a reference to the domain." localization_priority: Normal doc_type: apiPageType
v1.0 Domain List Serviceconfigurationrecords https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/domain-list-serviceconfigurationrecords.md
Title: "List serviceConfigurationRecords"
description: "Retrieves a list of domainDnsRecord objects needed to enable services for the domain." localization_priority: Normal doc_type: apiPageType
v1.0 Domain List Verificationdnsrecords https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/domain-list-verificationdnsrecords.md
Title: "List verificationDnsRecords"
description: "Retrieve a list of domainDnsRecord objects." localization_priority: Normal doc_type: apiPageType
v1.0 Domain List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/domain-list.md
Title: "List domains"
description: "Retrieve a list of domain objects." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Directory.Read.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Domain.Read.All, Domain.ReadWrite.All, Directory.Read.All |
+|Application | Directory.Read.All, Domain.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Domain Post Domains https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/domain-post-domains.md
Title: "Create domain"
description: "Adds a domain to the tenant." localization_priority: Normal doc_type: apiPageType
v1.0 Domain Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/domain-update.md
Title: "Update domain"
description: "Update the properties of domain object." localization_priority: Normal doc_type: apiPageType
v1.0 Domain Verify https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/domain-verify.md
Title: "domain: verify"
description: "Validates the ownership of the domain." localization_priority: Normal doc_type: apiPageType
v1.0 Drive Post Bundles https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/drive-post-bundles.md
+ Title: Create bundle description: Create a bundle of driveItems localization_priority: Normal
This bundle can be used to share a collection of files with other users without
# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "create-bundle" } -->
-```http
+```json
POST https://graph.microsoft.com/beta/drive/bundles Content-Type: application/json
Content-Type: application/json
<!-- { "blockType": "response", "@odata.type": "microsoft.graph.driveItem", "truncated": true } -->
-```http
+```json
HTTP/1.1 201 Created Content-Type: application/json
The request to create a new photo album is similar, although inside the bundle f
# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "create-album" } -->
-```http
+```json
POST https://graph.microsoft.com/beta/drive/bundles Content-Type: application/json
Content-Type: application/json
<!-- { "blockType": "response", "@odata.type": "microsoft.graph.driveItem", "truncated": true } -->
-```http
+```json
HTTP/1.1 201 Created Content-Type: application/json
v1.0 Driveitem Follow https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/driveitem-follow.md
One of the following permissions is required to call this API. To learn more, in
```http POST /drives/{drive-id}/items/{item-id}/follow
-POST /groups/{group-id}/drive/items/{item-id}/follow
+POST /groups/{group-id/drive/items/{item-id}/follow
POST /me/drive/items/{item-id}/follow POST /sites/{site-id}/drive/items/{item-id}/follow POST /users/{user-id}/drive/items/{item-id}/follow
v1.0 Driveitem Invite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/driveitem-invite.md
Here is an example of the response.
<!-- { "blockType": "response", "@odata.type": "Collection(microsoft.graph.permission)", "truncated": true } -->
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
Here is an example of the partial response.
<!-- { "blockType": "response", "@odata.type": "Collection(microsoft.graph.permission)", "truncated": true } -->
-```http
+```json
HTTP/1.1 207 Multi-Status Content-type: application/json
v1.0 Driveitem List Versions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/driveitem-list-versions.md
One of the following permissions is required to call this API. To learn more, in
```http GET /drives/{drive-id}/items/{item-id}/versions
-GET /groups/{group-id}/drive/items/{item-id}/versions
+GET /groups/{group-id}/drive/{item-id}/versions
GET /me/drive/items/{item-id}/versions GET /sites/{site-id}/drive/items/{item-id}/versions GET /users/{user-id}/drive/items/{item-id}/versions
v1.0 Driveitem Move https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/driveitem-move.md
One of the following permissions is required to call this API. To learn more, in
```http PATCH /drives/{drive-id}/items/{item-id}
-PATCH /groups/{group-id}/drive/items/{item-id}
+PATCH /groups/{group-id}/drive/{item-id}
PATCH /me/drive/items/{item-id} PATCH /sites/{site-id}/drive/items/{item-id} PATCH /users/{user-id}/drive/items/{item-id}
v1.0 Driveitem Unfollow https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/driveitem-unfollow.md
+ description: Unfollow an item that the user is following. Title: Unfollow drive item localization_priority: Normal
v1.0 Driveitemversion Get Contents https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/driveitemversion-get-contents.md
One of the following permissions is required to call this API. To learn more, in
```http GET /drives/{drive-id}/items/{item-id}/versions/{version-id}/content
-GET /groups/{group-id}/drive/items/{item-id}/versions/{version-id}/content
+GET /groups/{group-id}/drive/{item-id}/versions/{version-id}/content
GET /me/drive/items/{item-id}/versions/{version-id}/content GET /sites/{site-id}/drive/items/{item-id}/versions/{version-id}/content GET /users/{user-id}/drive/items/{item-id}/versions/{version-id}/content
v1.0 Driveitemversion Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/driveitemversion-get.md
One of the following permissions is required to call this API. To learn more, in
```http GET /drives/{drive-id}/items/{item-id}/versions/{version-id}
-GET /groups/{group-id}/drive/items/{item-id}/versions/{version-id}
+GET /groups/{group-id}/drive/{item-id}/versions/{version-id}
GET /me/drive/items/{item-id}/versions/{version-id} GET /sites/{site-id}/drive/items/{item-id}/versions/{version-id} GET /users/{user-id}/drive/items/{item-id}/versions/{version-id}
v1.0 Dynamics Account Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-account-get.md
If successful, this method returns a `200 OK` response code and an **accounts**
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/accounts/{id} ```
v1.0 Dynamics Agedaccountspayable Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-agedaccountspayable-get.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
GET /financials/companies/{id}/agedAccountsPayable ``` ## Optional query parameters
If successful, this method returns a `200 OK` response code and an **agedAccount
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/agedAccountsPayable?$filter=periodLengthFilter eq '3M' ```
v1.0 Dynamics Agedaccountsreceivable Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-agedaccountsreceivable-get.md
documentationcenter: '' localization_priority: Normal+ doc_type: apiPageType ms.prod: "dynamics-365-business-central"
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
GET /financials/companies/{id}/agedAccountsReceivable ``` ## Optional query parameters
If successful, this method returns a `200 OK` response code and an **agedAccount
Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/agedAccountsReceivable?$filter=periodLengthFilter eq '3M' ```
v1.0 Dynamics Companies Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-companies-get.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
GET /financials/companies ``` ## Optional query parameters
If successful, this method returns a `200 OK` response code and a **companies**
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies ```
v1.0 Dynamics Companyinformation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-companyinformation-get.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
GET /financials/companies/{id}/companyInformation/{id} ``` ## Optional query parameters
If successful, this method returns a `200 OK` response code and a **companyInfor
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/companyInformation/{id} ```
v1.0 Dynamics Companyinformation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-companyinformation-update.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
PATCH /financials/companies/{id}/companyInformation/{id} ```
If successful, this method returns a `200 OK` response code and an updated an **
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/companyInformation/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Countriesregions Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-countriesregions-delete.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
DELETE /financials/companies/{id}/countriesRegions/{id} ``` ## Optional query parameters
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/countriesRegions/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/countriesRegio
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Countriesregions Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-countriesregions-get.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
GET /financials/companies/{id}/countriesRegions/{id} ```
If successful, this method returns a `200 OK` response code and a **countriesReg
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/countriesRegions/{id} ```
v1.0 Dynamics Countriesregions Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-countriesregions-update.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
PATCH /financials/companies/{id}/countriesRegions/{id} ```
If successful, this method returns a `200 OK` response code and an updated **cou
Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/countriesRegions/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Create Countriesregions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-countriesregions.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
POST /financials/companies/{id}/countriesRegions ```
If successful, this method returns ```201 Created``` response code and a **count
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/countriesRegions Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Currencies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-currencies.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
POST /financials/companies/{id}/currencies ```
If successful, this method returns ```201 Created``` response code and a **curre
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/currencies Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Customer https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-customer.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
POST /financials/companies/{id}/customers ```
If successful, this method returns ```201 Created``` response code and a **custo
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/customers Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Customerpayment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-customerpayment.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
POST /financials/companies/{id}/customerPaymentJournals/{id}/customerPayments/{id} ```
If successful, this method returns ```201 Created``` response code and a **custo
Here is an example of a request.
-```http
-POST https://graph.microsoft.com/beta/financials/companies/{id}/customerPaymentJournals/{id}/customerPayments
+```json
+POST https://graph.microsoft.com/beta/financials/companies/{id}/customerPaymentJournal/{id}/customerPayments
Content-type: application/json {
Content-type: application/json
``` **Response**
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Customerpaymentsjournal https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-customerpaymentsjournal.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-```http
+```
POST /financials/companies/{id}/customerPaymentJournals/{id} ```
If successful, this method returns ```201 Created``` response code and a **custo
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/customerPaymentJournals Content-type: application/json
+```json
{ "code": "DEFAULT" }
Content-type: application/json
**Response**
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Employee https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-employee.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
POST /financials/companies/{id}/employees ```
If successful, this method returns ```201 Created``` response code and an **empl
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/employees Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Item https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-item.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
POST /financials/companies/{id}/items ```
If successful, this method returns ```201 Created``` response code and an **item
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/items Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Itemcategories https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-itemcategories.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
POST /financials/companies/{id}/itemCategories ```
If successful, this method returns ```201 Created``` response code and an **item
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/itemCategories Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Journal https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-journal.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-```http
+```
POST /financials/companies/{id}/journals/{id} ```
If successful, this method returns ```201 Created``` response code and a **journ
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/journals Content-type: application/json
+```json
{ "code": "DEFAULT" }
Content-type: application/json
**Response**
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Journalline https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-journalline.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-```http
+```
POST /financials/companies/{id}/journals/{id}/journalLines/{id} ```
If successful, this method returns ```201 Created``` response code and **journal
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/journals/{id}/journalLines Content-type: application/json
Content-type: application/json
``` **Response**
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Paymentmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-paymentmethods.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
POST /financials/companies/{id}/paymentMethods ```
If successful, this method returns ```201 Created``` response code and a **payme
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/paymentMethods Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Paymentterms https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-paymentterms.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
POST /financials/companies/{id}/paymentTerms ```
If successful, this method returns ```201 Created``` response code and a **payme
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/paymentTerms Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Shipmentmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-shipmentmethods.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
POST /financials/companies/{id}/shipmentMethods ```
If successful, this method returns ```201 Created``` response code and a **shipm
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/shipmentMethods Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Taxarea https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-taxarea.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-```http
+```
POST /financials/companies/{id}/taxAreas/{id} ```
If successful, this method returns ```201 Created``` response code and a **taxAr
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/taxAreas Content-type: application/json
+```json
{ "code": "44442001T" }
Content-type: application/json
**Response**
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Taxgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-taxgroups.md
If successful, this method returns ```201 Created``` response code and a **taxGr
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/taxGroups Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Unitsofmeasure https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-unitsofmeasure.md
If successful, this method returns ```201 Created``` response code and a **units
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/unitsOfMeasure Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
v1.0 Dynamics Create Vendor https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-create-vendor.md
One of the following permissions is required to call this API. To learn more, in
|Application|Financials.ReadWrite.All| ## HTTP request
-```http
+```
POST /financials/companies/{id}/vendors ```
If successful, this method returns ```201 Created``` response code and a **vendo
Here is an example of a request.
-```http
+```json
POST https://graph.microsoft.com/beta/financials/companies/{id}/vendors Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 201 Created Content-type: application/json
Content-type: application/json
"displayName": "Wide World Importers", "lastModifiedDateTime": "2015-11-09T02:14:32Z" }+ ```
v1.0 Dynamics Currencies Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-currencies-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/currencies/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/currencies/{id
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Currencies Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-currencies-get.md
If successful, this method returns a `200 OK` response code and a **currencies**
Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/currencies/{id} ```
v1.0 Dynamics Currencies Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-currencies-update.md
If successful, this method returns a `200 OK` response code and an updated **cur
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/currencies/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Customer Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-customer-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/customers/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/customers/{id}
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Customer Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-customer-get.md
If successful, this method returns a `200 OK` response code and a **customers**
Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/customers/{id} ```
v1.0 Dynamics Customer Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-customer-update.md
If successful, this method returns a `200 OK` response code and an updated **cus
Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/customers/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Customerpayment Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-customerpayment-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/customerPaymentJournals/{id}/customerPayments/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/customerPaymen
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Customerpayment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-customerpayment-get.md
If successful, this method returns a `200 OK` response code and a **customerPaym
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/customerPaymentJournals/{id}/customerPayments/{id} ```
v1.0 Dynamics Customerpayment Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-customerpayment-update.md
If successful, this method returns a `200 OK` response code and an updated **cus
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/customerPaymentJournals/{id}/customerPayments/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Customerpaymentsjournal Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-customerpaymentsjournal-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/customerPaymentJournals/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/customerPaymen
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Customerpaymentsjournal Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-customerpaymentsjournal-get.md
If successful, this method returns a `200 OK` response code and a **customerPaym
Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/customerPaymentJournals/{id} ```
v1.0 Dynamics Customerpaymentsjournal Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-customerpaymentsjournal-update.md
If successful, this method returns a `200 OK` response code and an updated **cus
Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/customerPaymentJournals/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Dimension Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-dimension-get.md
If successful, this method returns a `200 OK` response code and a **dimensions**
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/dimensions/{id} ```
v1.0 Dynamics Dimensionvalue Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-dimensionvalue-get.md
If successful, this method returns a `200 OK` response code and a **dimensionVal
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/dimensions/{id}/dimensionValues/{id} ```
v1.0 Dynamics Employee Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-employee-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/employees/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/employees/{id}
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Employee Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-employee-get.md
If successful, this method returns a `200 OK` response code and an **employees**
Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/employees/{id} ```
v1.0 Dynamics Employee Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-employee-update.md
If successful, this method returns a `200 OK` response code and an updated **emp
Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/employees/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Generalledgerentries Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-generalledgerentries-get.md
If successful, this method returns a `200 OK` response code and a **generalLedge
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/generalLedgerEntries/{id} ```
v1.0 Dynamics Item Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-item-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
**Request** Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/items/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/items/{id}
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Item Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-item-get.md
If successful, this method returns a `200 OK` response code and an **items** obj
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/items/{id} ```
v1.0 Dynamics Item Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-item-update.md
If successful, this method returns a `200 OK` response code and an updated **ite
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/items/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Itemcategories Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-itemcategories-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/itemCategories/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/itemCategories
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Itemcategories Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-itemcategories-get.md
If successful, this method returns a `200 OK` response code and an **itemCategor
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/itemCategories/{id} ```
v1.0 Dynamics Itemcategories Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-itemcategories-update.md
If successful, this method returns a `200 OK` response code and an updated **ite
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/itemCategories/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Journal Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-journal-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/journals/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/journals/{id}
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Journal Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-journal-get.md
If successful, this method returns a `200 OK` response code and a **journals** o
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/journals/{id} ```
v1.0 Dynamics Journal Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-journal-update.md
If successful, this method returns a `200 OK` response code and an updated **jou
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/journals/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Journalline Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-journalline-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/journals/{id}/journalLines/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/journals/{id}/
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Journalline Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-journalline-get.md
If successful, this method returns a `200 OK` response code and a **journalLines
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/journals/{id}/journalLines/{id} ```
v1.0 Dynamics Journalline Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-journalline-update.md
If successful, this method returns a `200 OK` response code and an updated **jou
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/journals/{id}/journalLines/{id} Content-type: application/json
Content-type: application/json
**Response**
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Paymentmethods Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-paymentmethods-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/paymentMethods/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/paymentMethods
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Paymentmethods Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-paymentmethods-get.md
If successful, this method returns a `200 OK` response code and a **paymentMetho
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/paymentMethods/{id} ```
v1.0 Dynamics Paymentmethods Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-paymentmethods-update.md
If successful, this method returns a `200 OK` response code and an updated **pay
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/paymentMethods/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Paymentterms Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-paymentterms-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/paymentTerms/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/paymentTerms/{
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Paymentterms Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-paymentterms-get.md
If successful, this method returns a `200 OK` response code and a **paymentTerms
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/paymentTerms/{id} ```
v1.0 Dynamics Paymentterms Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-paymentterms-update.md
If successful, this method returns a `200 OK` response code and an updated **pay
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/paymentTerms/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Shipmentmethods Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-shipmentmethods-delete.md
If successful, this method returns ```204,No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/shipmentMethods/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/shipmentMethod
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Shipmentmethods Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-shipmentmethods-get.md
If successful, this method returns a `200 OK` response code and a **shipmentMeth
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/shipmentMethods/{id} ```
v1.0 Dynamics Shipmentmethods Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-shipmentmethods-update.md
If successful, this method returns a `200 OK` response code and an updated **shi
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/shipmentMethods/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Taxgroups Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-taxGroups-update.md
If successful, this method returns a `200 OK` response code and an updated **tax
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/taxGroups/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Taxarea Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-taxarea-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/taxAreas/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/taxAreas/{id}
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Taxarea Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-taxarea-get.md
If successful, this method returns a `200 OK` response code and a **taxAreas** o
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/taxAreas/{id} ```
v1.0 Dynamics Taxarea Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-taxarea-update.md
If successful, this method returns a `200 OK` response code and an updated **tax
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/taxAreas/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Taxgroups Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-taxgroups-delete.md
If successful, this method returns ```204,No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/taxGroups/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/taxGroups/{id}
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Taxgroups Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-taxgroups-get.md
If successful, this method returns a `200 OK` response code and a **taxGroups**
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/taxGroups/{id} ```
v1.0 Dynamics Trialbalance Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-trialbalance-get.md
+
+ Title: Get trialBalance
+description: Gets a trial balance object in Dynamics 365 Business Central.
+
+documentationcenter: ''
+
+localization_priority: Normal
++
+# Get trialBalance
+
+Namespace: microsoft.graph
++
+Retrieve the properties and relationships of a trial balance report object for Dynamics 365 Business Central.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type |Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Financials.ReadWrite.All |
+|Delegated (personal Microsoft account|Not supported.|
+|Application|Financials.ReadWrite.All|
+
+## HTTP request
+```
+GET /financials/companies/{id}/trialBalance
+```
+
+## Optional query parameters
+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+
+## Request headers
+|Header|Value|
+||--|
+|Authorization |Bearer {token}. Required. |
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a **trialBalance** object in the response body.
+
+## Example
+
+**Request**
+
+Here is an example of the request.
+```json
+GET https://graph.microsoft.com/beta/financials/companies/{id}/trialBalance?$orderby number&$filter=dateFilter ge 2019-01-01 and dateFilter le 2019-12-31
+```
+
+**Response**
+
+Here is an example of the response.
+
+> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+```json
+{
+ "number": "1110",
+ "accountId": "id-value",
+ "accountType": "Posting",
+ "display": "Accounts Receivable",
+ "totalDebit": "479.00",
+ "totalCredit": "0.00",
+ "balanceAtDateDebit": "72,893.84",
+ "balanceAtDateCredit": "0.00",
+ "dateFilter": "2019-12-31"
+}
+```
+++
v1.0 Dynamics Unitsofmeasure Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-unitsofmeasure-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/unitsOfMeasure/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/unitsOfMeasure
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Unitsofmeasure Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-unitsofmeasure-get.md
If successful, this method returns a `200 OK` response code and a **unitsOfMeasu
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/unitsOfMeasure/{id} ```
v1.0 Dynamics Unitsofmeasure Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-unitsofmeasure-update.md
If successful, this method returns a `200 OK` response code and an updated **uni
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/unitsOfMeasure/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Dynamics Vendor Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-vendor-delete.md
If successful, this method returns ```204 No Content``` response code. It does n
Here is an example of the request.
-```http
+```json
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/vendors/{id} ```
DELETE https://graph.microsoft.com/beta/financials/companies/{id}/vendors/{id}
Here is an example of the response.
-```http
+```json
HTTP/1.1 204 No Content ```
v1.0 Dynamics Vendor Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-vendor-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-```http
+```
GET /financials/companies/{id}/vendors/{id} ```
If successful, this method returns a `200 OK` response code and a **vendors** ob
**Request** Here is an example of the request.
-```http
+```json
GET https://graph.microsoft.com/beta/financials/companies/{id}/vendors/{id} ```
v1.0 Dynamics Vendor Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-vendor-update.md
If successful, this method returns a `200 OK` response code and an updated **ven
**Request** Here is an example of the request.
-```http
+```json
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/vendors/{id} Content-type: application/json
Here is an example of the response.
> **Note**: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
-```http
+```json
HTTP/1.1 200 OK Content-type: application/json
v1.0 Ediscovery Case List Legalholds https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-case-list-legalholds.md
- Title: "List legalHolds"
-description: "Get the legalHold resources from the legalHolds navigation property."
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# List legalHolds
-
-Namespace: microsoft.graph.ediscovery
--
-Get the [legalHolds](../resources/ediscovery-legalhold.md) that are applied to a case.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/legalHolds
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [legalHold](../resources/ediscovery-legalhold.md) objects in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_legalhold"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/legalHolds
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.legalHold)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.ediscovery.legalHold",
- "id": "700cd868-d868-700c-68d8-0c7068d80c70",
- "description": "String",
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "lastModifiedBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "lastModifiedDateTime": "String (timestamp)",
- "isEnabled": "Boolean",
- "status": "String",
- "contentQuery": "String",
- "errors": [
- "String"
- ],
- "displayName": "String",
- "createdDateTime": "String (timestamp)"
- }
- ]
-}
-```
v1.0 Ediscovery Case List Operations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-case-list-operations.md
- Title: "List operations"
-description: "Get the list caseOperations from a case object."
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# List operations
-
-Namespace: microsoft.graph.ediscovery
--
-Get the list of [caseOperations](../resources/ediscovery-caseoperation.md) from a [case](../resources/ediscovery-case.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/operations
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.ediscovery.caseOperation](../resources/ediscovery-caseoperation.md) objects in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_caseoperation"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/061b9a92-8926-4bd9-b41d-abf35edc7583/operations
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.caseOperation)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.ediscovery.caseOperation",
- "id": "41362b70-2b70-4136-702b-3641702b3641",
- "createdDateTime": "String (timestamp)",
- "completedDateTime": "String (timestamp)",
- "percentProgress": "Integer",
- "status": "String",
- "action": "String",
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "resultInfo": {
- "@odata.type": "microsoft.graph.resultInfo"
- }
- }
- ]
-}
-```
v1.0 Ediscovery Case List Reviewsets https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-case-list-reviewsets.md
- Title: "List reviewSets"
-description: "Get the reviewSet resources from a case object."
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# List reviewSets
-
-Namespace: microsoft.graph.ediscovery
--
-Get the list of [reviewSets](../resources/ediscovery-reviewset.md) from a [case](../resources/ediscovery-case.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/reviewSets
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.ediscovery.reviewSet](../resources/ediscovery-reviewset.md) objects in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_reviewset"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/reviewSets
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.reviewSet)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#cases",
- "@odata.nextLink": "https://graph.microsoft.com/beta/compliance/ediscovery/cases?$skiptoken=<encodedPageToken>",
- "value": [
- {
- "id": "f6a91542-4ce7-4712-b275-c29545dd8507",
- "displayName": "My Reviewset 1",
- "createdBy": {
- "user": {
- "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
- "displayName": "eDiscovery admin"
- }
- },
- "createdDateTime": "2020-01-16T11:58:27.1408174Z"
- },
- {
- "id": "0d78ec4a-aa91-41ea-8da8-d68b030c168f",
- "displayName": "My Reviewset 2",
- "createdBy": {
- "user": {
- "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
- "displayName": "eDiscovery admin"
- }
- },
- "createdDateTime": "2020-01-16T12:03:32.2038960Z"
- }
- ]
-}
-```
v1.0 Ediscovery Case List Sourcecollections https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-case-list-sourcecollections.md
- Title: "List sourceCollections"
-description: "Get the list of sourceCollections resources from a case object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List sourceCollections
-
-Namespace: microsoft.graph.ediscovery
--
-Get the list of [sourceCollections](../resources/ediscovery-sourcecollection.md) from a [case](../resources/ediscovery-case.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/sourceCollections
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.ediscovery.sourceCollection](../resources/ediscovery-sourcecollection.md) objects in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_sourcecollection"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/sourceCollections
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.sourceCollection)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases/c816dd6f-5af8-40c5-a760-331361e05c60/sourceCollections",
- "value": [
- {
- "description": "",
- "lastModifiedDateTime": "2020-12-31T18:54:28.80694Z",
- "createdBy": {
- "user": {
- "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
- "displayName": "eDiscovery admin"
- }
- },
- "lastModifiedBy": {
- "user": {
- "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
- "displayName": "eDiscovery admin"
- }
- },
- "contentQuery": "subject:'Quarterly Financials'",
- "tenantSources": "none",
- "id": "fe5ef84e9c8c45819c056f6eb261718e",
- "displayName": "Quarterly Financials",
- "createdDateTime": "2020-12-11T22:56:14.2329133Z"
- }
- ]
-}
-```
v1.0 Ediscovery Case List Tags https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-case-list-tags.md
- Title: "List tags"
-description: "Get a list of tag resources from an eDiscovery case."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List tags
-
-Namespace: microsoft.graph.ediscovery
--
-Retrieve a list of [tag](../resources/ediscovery-tag.md) objects from an eDiscovery [case](../resources/ediscovery-case.md).
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/tags
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.ediscovery.tag](../resources/ediscovery-tag.md) objects in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_tag"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/tags
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.tag)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/tags",
- "value": [
- {
- "displayName": "Responsiveness",
- "description": "Indicates the responsiveness of the document",
- "lastModifiedDateTime": "2021-01-11T19:32:23.1903658Z",
- "childSelectability": "One",
- "id": "e54b3f535b434a9a8743b84e34c00504",
- "createdBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": "EDisco Admin",
- "userPrincipalName": "admin@contoso.com"
- }
- },
- "parent": null,
- "childTags": []
- },
- {
- "displayName": "Yes",
- "description": "The document is responsive",
- "lastModifiedDateTime": "2021-01-11T19:32:22.4091161Z",
- "childSelectability": "One",
- "id": "081ff31e7324423186e01b549efe7033",
- "createdBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": "EDisco Admin",
- "userPrincipalName": "admin@contoso.com"
- }
- },
- "parent": {
- "displayName": null,
- "createdBy": null,
- "description": null,
- "lastModifiedDateTime": "0001-01-01T00:00:00Z",
- "childSelectability": "One",
- "id": "e54b3f535b434a9a8743b84e34c00504"
- },
- "childTags": []
- },
- {
- "displayName": "No",
- "description": "The document is not responsive",
- "lastModifiedDateTime": "2021-01-11T19:32:21.5693878Z",
- "childSelectability": "One",
- "id": "61624e6c96a64ccea40e0d2c48e23e16",
- "createdBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": "EDisco Admin",
- "userPrincipalName": "admin@contoso.com"
- }
- },
- "parent": {
- "displayName": null,
- "createdBy": null,
- "description": null,
- "lastModifiedDateTime": "0001-01-01T00:00:00Z",
- "childSelectability": "One",
- "id": "e54b3f535b434a9a8743b84e34c00504"
- },
- "childTags": []
- }
- ]
-}
-```
v1.0 Ediscovery Case Post Legalholds https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-case-post-legalholds.md
- Title: "Create legalHold"
-description: "Create a new legalHold object."
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# Create legalHold
-
-Namespace: microsoft.graph.ediscovery
--
-Create a new [legalHold](../resources/ediscovery-legalhold.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-POST /compliance/ediscovery/cases/{caseId}/legalHolds
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply a JSON representation of the [legalHold](../resources/ediscovery-legalhold.md) object.
-
-The following table shows the properties that are required when you create the [legalHold](../resources/ediscovery-legalhold.md).
-
-|Property|Type|Description|
-|:|:|:|
-|displayName|String| The display name of the legal hold. |
-
-## Response
-
-If successful, this method returns a `201 Created` response code and a [microsoft.graph.ediscovery.legalHold](../resources/ediscovery-legalhold.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "create_legalhold_from_"
-}
>-
-``` http
-POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/legalHolds
-Content-Type: application/json
-Content-length: 295
-
-{
- "@odata.type": "#microsoft.graph.ediscovery.legalHold",
- "description": "String",
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "isEnabled": "Boolean",
- "status": "String",
- "contentQuery": "String",
- "errors": [
- "String"
- ],
- "displayName": "String"
-}
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.legalHold"
-}
>-
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-
-{
- "@odata.type": "#microsoft.graph.ediscovery.legalHold",
- "id": "700cd868-d868-700c-68d8-0c7068d80c70",
- "description": "String",
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "lastModifiedBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "lastModifiedDateTime": "String (timestamp)",
- "isEnabled": "Boolean",
- "status": "String",
- "contentQuery": "String",
- "errors": [
- "String"
- ],
- "displayName": "String",
- "createdDateTime": "String (timestamp)"
-}
-```
v1.0 Ediscovery Case Post Sourcecollections https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-case-post-sourcecollections.md
- Title: "Create sourceCollection"
-description: "Create a new sourceCollection object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create sourceCollection
-
-Namespace: microsoft.graph.ediscovery
--
-Create a new [sourceCollection](../resources/ediscovery-sourcecollection.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-POST /compliance/ediscovery/cases/{caseId}/sourceCollections
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply a JSON representation of the [sourceCollection](../resources/ediscovery-sourcecollection.md) object.
-
-The following table shows the properties that are required when you create the [sourceCollection](../resources/ediscovery-sourcecollection.md).
-
-|Property|Type|Description|
-|:|:|:|
-|displayName|String|The display name of the **sourceCollection**|
-|custodianSources|[microsoft.graph.ediscovery.dataSource](../resources/ediscovery-datasource.md) collection|The custodian sources to include in this search. You can get the URL from from custodian [siteSources](../api/ediscovery-custodian-list-sitesources.md), [unifiedGroupSources](../api/ediscovery-custodian-list-unifiedgroupsources.md), or [userSources](../api/ediscovery-custodian-list-usersources.md) plus the ID of the source. **Note:** Either one custodian or specifying tenant source is required when creating a source collection. |
-|tenantSources|microsoft.graph.ediscovery.tenantSources|When specified, the collection will span across a service for an entire workload. Possible values are: `allMailboxes`, `allSites`. **Note:** Either one custodian or specifying tenant source is required when creating a source collection.|
-
-## Response
-
-If successful, this method returns a `201 Created` response code and a [microsoft.graph.ediscovery.sourceCollection](../resources/ediscovery-sourcecollection.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "create_sourcecollection_from_"
-}
>-
-``` http
-POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/sourceCollections
-Content-Type: application/json
-Content-length: 272
-
-{
- "displayName": "Quarterly Financials search",
- "contentQuery": "subject:'Quarterly Financials'",
- "custodianSources@odata.bind": [
- "https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/custodians/2192ca408ea2410eba3bec8ae873be6b/userSources/46384443-4137-3032-3437-363939433735"
- ]
-}
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.sourceCollection"
-}
>-
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/sourceCollections/$entity",
- "description": null,
- "lastModifiedDateTime": "2021-01-12T18:09:03.7378679Z",
- "contentQuery": "subject:'Quarterly Financials'",
- "tenantSources": "none",
- "id": "1a9b4145d8f84e39bc45a7f68c5c5119",
- "displayName": "Quarterly Financials search",
- "createdDateTime": "2021-01-12T18:09:03.417009Z",
- "createdBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": "EDisco Admin",
- "userPrincipalname": "admin@contoso.com"
- }
- },
- "lastModifiedBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": "EDisco Admin",
- "userPrincipalname": "admin@contoso.com"
- }
- }
-}
-```
v1.0 Ediscovery Case Post Tags https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-case-post-tags.md
- Title: "Create tag"
-description: "Create a new tag object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create tag
-
-Namespace: microsoft.graph.ediscovery
--
-Create a new tag for the specified case. The tags are used in review sets while reviewing content.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-POST /compliance/ediscovery/cases/{caseId}/tags
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply a JSON representation of the [tag](../resources/ediscovery-tag.md) object.
-
-The following table shows the properties that are required when you create the [tag](../resources/ediscovery-tag.md).
-
-|Property|Type|Description|
-|:|:|:|
-|childSelectability|[microsoft.graph.ediscovery.childSelectability](../resources/ediscovery-tag.md#childselectability-values)|Indicates whether a single or multiple child tags can be associated with a document. Possible values are: `One`, `Many`. This value controls whether the UX presents the tags as checkboxes or a radio button group. Required.|
-|displayName|String|Display name of the tag. Required.|
-
-## Response
-
-If successful, this method returns a `201 Created` response code and a [microsoft.graph.ediscovery.tag](../resources/ediscovery-tag.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "create_tag_from_"
-}
>-
-``` http
-POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/tags
-Content-Type: application/json
-Content-length: 235
-
-{
- "displayName":"Privileged",
- "description":"The document is privileged",
- "parent@odata.bind":"https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/tags/98fdad78bbce4519b75474bc150575c3"
-}
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.tag"
-}
>-
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/tags/$entity",
- "displayName": "Privileged",
- "description": "The document is privileged",
- "lastModifiedDateTime": "2021-01-12T01:01:09.0419153Z",
- "childSelectability": "One",
- "id": "0825ef81ade74095a3b3154a3c434c3e",
- "createdBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": null,
- "userPrincipalName": "admin@contoso.com"
- }
- }
-}
-```
v1.0 Ediscovery Caseexportoperation Getdownloadurl https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-caseexportoperation-getdownloadurl.md
- Title: "caseExportOperation: getDownloadUrl"
-description: "Returns the download URL "
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# caseExportOperation: getDownloadUrl
-
-Namespace: microsoft.graph.ediscovery
--
-Returns the download URL for an export when the export is ready.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/operations/{operationId}/microsoft.graph.ediscovery.caseExportOperation/getDownloadUrl
-```
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this function returns a `200 OK` response code and a String in the response body. The value field represents the download URL from where the export can be retrieved.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "caseexportoperation_getdownloadurl"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/99e865fc-e29f-479a-ba83-9e58eb017103/operations/63926d4779c243458902328d83f61f53/microsoft.graph.ediscovery.caseExportOperation/getDownloadUrl
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Edm.String"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#Edm.String",
- "value": "https://nam01pkgg0052.blob.edproxy.nam01.ediscovery.outlook.com/packaging0041e27c6c924a48befe348d34066c25/d0b6d2a7-5fc5-44f0-9bca-6b9d34a9410b.zip?sv=2018-03-28&sr=c&sig=TRFQNUGFtuVO7zd39oNJjzcQYJus2TXY%2B50aed4pJJM%3D&se=2020-12-28T23%3A06%3A26Z&sp=racwdl"
-}
-```
v1.0 Ediscovery Custodian Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-custodian-update.md
- Title: "Update custodian"
-description: "Update the properties of a custodian object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update custodian
-
-Namespace: microsoft.graph.ediscovery
--
-Update the properties of a [custodian](../resources/ediscovery-custodian.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-PATCH /compliance/ediscovery/cases/{caseId}/custodians/{custodianId}
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
-
-|Property|Type|Description|
-|:|:|:|
-|applyHoldToSources|Boolean|Identifies whether a custodian's sources were placed on hold during creation.|
-
-## Response
-
-If successful, this action returns a `204 No Content` response code.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "update_custodian"
-}
>-
-``` http
-PATCH https://graph.microsoft.com/beta/compliance/ediscovery/cases/2192ca408ea2410eba3bec8ae873be6b/custodians/45454331323337443946343043464239
-Content-Type: application/json
-Content-length: 254
-
-{
- "applyHoldToSources": "false",
-}
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.custodian"
-}
>-
-``` http
-HTTP/1.1 204 No Content
-```
v1.0 Ediscovery Legalhold Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-legalhold-delete.md
- Title: "Delete legalHold"
-description: "Delete a legalHold object."
-
-localization_priority: Normal
-doc_type: "apiPageType"
--
-# Delete legalHold
-
-Namespace: microsoft.graph.ediscovery
--
-Delete a [legalHold](../resources/ediscovery-legalhold.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-DELETE /compliance/ediscovery/cases/{caseId}/legalHolds/{legalHoldId}
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `204 No Content` response code.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "delete_legalhold"
-}
>-
-``` http
-DELETE https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/legalHolds/{legalholdId}
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>-
-``` http
-HTTP/1.1 204 No Content
-```
v1.0 Ediscovery Legalhold Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-legalhold-get.md
- Title: "Get legalHold"
-description: "Read the properties and relationships of a legalHold object."
-localization_priority: Normal
-
-doc_type: apiPageType
--
-# Get legalHold
-
-Namespace: microsoft.graph.ediscovery
--
-Read the properties and relationships of a [legalHold](../resources/ediscovery-legalhold.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/legalHolds/{legalholdId}
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a [microsoft.graph.ediscovery.legalHold](../resources/ediscovery-legalhold.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "get_legalhold"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/legalHolds/{legalholdId}
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.legalHold"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "value": {
- "@odata.type": "#microsoft.graph.ediscovery.legalHold",
- "id": "700cd868-d868-700c-68d8-0c7068d80c70",
- "description": "String",
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "lastModifiedBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "lastModifiedDateTime": "String (timestamp)",
- "isEnabled": "Boolean",
- "status": "String",
- "contentQuery": "String",
- "errors": [
- "String"
- ],
- "displayName": "String",
- "createdDateTime": "String (timestamp)"
- }
-}
-```
v1.0 Ediscovery Legalhold List Sitesources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-legalhold-list-sitesources.md
- Title: "List legalHold siteSources"
-description: "Get the list of siteSource objecs associated with a legal hold."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List legalHold siteSources
-
-Namespace: microsoft.graph.ediscovery
--
-Get the list of [siteSource](../resources/ediscovery-sitesource.md) objecs associated with a legal hold.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions- reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/legalHolds/{legalholdId}/siteSources
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.ediscovery.siteSource](../resources/ediscovery-sitesource.md) objects in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_sitesource"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/c816dd6f-5af8-40c5-a760-331361e05c60/legalHolds/277107ff-fee3-41a0-a665-a9d7f6c4824f/siteSources
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.siteSource)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('c816dd6f-5af8-40c5-a760-331361e05c60')/legalHolds('277107ff-fee3-41a0-a665-a9d7f6c4824f')/siteSources",
- "value": [
- {
- "displayName": "Microsoft Team Site",
- "createdDateTime": "2020-10-30T21:02:41.887Z",
- "id": "43aab990-183e-4593-b772-578bb129e89b",
- "createdBy": {
- "user": {
- "id": null,
- "displayName": "eDiscovery admin"
- }
- }
- },
- {
- "displayName": "Adele Vance",
- "createdDateTime": "2020-10-30T21:02:41.887Z",
- "id": "e87b37ac-fad4-471b-9dd8-0e16000a3554",
- "createdBy": {
- "user": {
- "id": null,
- "displayName": "eDiscovery admin"
- }
- }
- }
- ]
-}
-```
v1.0 Ediscovery Legalhold List Usersources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-legalhold-list-usersources.md
- Title: "List legalHold userSources"
-description: "Get the userSource resources from the userSources navigation property."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List legalHold userSources
-
-Namespace: microsoft.graph.ediscovery
--
-Get the list of [userSource](../resources/ediscovery-usersource.md) objects associated with a legal hold.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/legalHolds/{legalholdId}/userSources
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.ediscovery.userSource](../resources/ediscovery-usersource.md) objects in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_usersource"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/c816dd6f-5af8-40c5-a760-331361e05c60/legalHolds/277107ff-fee3-41a0-a665-a9d7f6c4824f/userSources
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.userSource)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('c816dd6f-5af8-40c5-a760-331361e05c60')/legalholds('277107ff-fee3-41a0-a665-a9d7f6c4824f')/userSources",
- "value": [
- {
- "displayName": "Adele Vance",
- "createdDateTime": "2020-10-30T21:02:41.887Z",
- "id": "2f279b24-2142-435d-97c5-0d42220ba453",
- "email": "AdeleV@contoso.com",
- "includedSources": "mailbox",
- "createdBy": {
- "user": {
- "id": null,
- "displayName": "eDiscovery admin"
- }
- }
- }
- ]
-}
-```
v1.0 Ediscovery Legalhold Post Sitesources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-legalhold-post-sitesources.md
- Title: "Create legalHold siteSource"
-description: "Create a new legalHold siteSource object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create legalHold siteSource
-
-Namespace: microsoft.graph.ediscovery
--
-Adds a siteSource to a legalHold object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-POST /compliance/ediscovery/cases/{caseId}/legalHolds/{legalholdId}/siteSources
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply a JSON representation of the [siteSource](../resources/ediscovery-sitesource.md) object.
-
-The following table shows the properties that are required when you create the [siteSource](../resources/ediscovery-sitesource.md).
-
-|Property|Type|Description|
-|:|:|:|
-|site@odata.bind|String|ID of the site, which you can get from the [site](../resources/site.md) resource by using the [Get a site resource by path](../api/site-getbypath.md) method. The usage is {hostname}:/{relative-path}. For the site URL `https://contoso.sharepoint.com/sites/HumanResources`, the Microsoft Graph request would be `https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/HumanResources`. The ID is the first GUID listed in the ID field. For the OneDrive for business site URL `https://contoso-my.sharepoint.com/personal/adelev_contoso_com`, the Microsoft Graph request would be `https://graph.microsoft.com/v1.0/sites/contoso-my.sharepoint.com:/personal/adelev_contoso_com` |
-
-## Response
-
-If successful, this method returns a `201 Created` response code and a [microsoft.graph.ediscovery.siteSource](../resources/ediscovery-sitesource.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "create_sitesource_from_"
-}
>-
-``` http
-POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/c816dd6f-5af8-40c5-a760-331361e05c60/legalHolds/387566cc-38ae-4e85-ab4b-cd2dd34faa07/siteSources
-Content-Type: application/json
-Content-length: 154
-
-{
- "site@odata.bind": "https://graph.microsoft.com/v1.0/sites/50073f3e-cb22-48e5-95a9-51a3da455181"
-}
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.siteSource"
-}
>-
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('c816dd6f-5af8-40c5-a760-331361e05c60')/legalHolds('387566cc-38ae-4e85-ab4b-cd2dd34faa07')/siteSources/$entity",
- "displayName": "Adele Vance",
- "createdDateTime": "2020-12-28T20:08:57.857Z",
- "id": "50073f3e-cb22-48e5-95a9-51a3da455181",
- "createdBy": {
- "user": {
- "id": null,
- "displayName": "EDiscovery admin"
- }
- }
-}
-```
v1.0 Ediscovery Legalhold Post Usersources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-legalhold-post-usersources.md
- Title: "Create legalHold userSource"
-description: "Create a new legalHold userSource object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create legalHold userSource
-
-Namespace: microsoft.graph.ediscovery
--
-Adds a userSource to a legalHold object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-POST /compliance/ediscovery/cases/{caseId}/legalHolds/{legalholdId}/userSources
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply a JSON representation of the [userSource](../resources/ediscovery-usersource.md) object.
-
-The following table shows the properties that are required when you create the [userSource](../resources/ediscovery-usersource.md).
-
-|Property|Type|Description|
-|:|:|:|
-|email|String|SMTP address of the user.|
-|includedSources|microsoft.graph.ediscovery.sourceType|Specifies which sources are included in this group. This value must be `mailbox`, `site` is not supported for legalHolds at this time.|
-
-## Response
-
-If successful, this method returns a `201 Created` response code and a [microsoft.graph.ediscovery.userSource](../resources/ediscovery-usersource.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "create_usersource_from_"
-}
>-
-``` http
-POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/c816dd6f-5af8-40c5-a760-331361e05c60/legalHolds/387566cc-38ae-4e85-ab4b-cd2dd34faa07/userSources
-Content-Type: application/json
-Content-length: 208
-
-{
- "email": "adelev@contoso.com",
- "includedSources": "mailbox"
-}
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.userSource"
-}
>-
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases/c816dd6f-5af8-40c5-a760-331361e05c60/legalholds/387566cc-38ae-4e85-ab4b-cd2dd34faa07/userSources",
- "value": [
- {
- "displayName": "Adele Vance",
- "createdDateTime": "2020-12-28T20:08:57.857Z",
- "id": "2192ca40-8ea2-410e-ba3b-ec8ae873be6b",
- "email": "AdeleV@contoso.com",
- "includedSources": "mailbox",
- "createdBy": {
- "user": {
- "id": null,
- "displayName": "EDiscovery admin"
- }
- }
- }
- ]
-}
-```
v1.0 Ediscovery Legalhold Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-legalhold-update.md
- Title: "Update legalHold"
-description: "Update the properties of a legalHold object."
-localization_priority: Normal
-
-doc_type: apiPageType
--
-# Update legalHold
-
-Namespace: microsoft.graph.ediscovery
--
-Update the properties of a [legalHold](../resources/ediscovery-legalhold.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-PATCH /compliance/ediscovery/cases/{caseId}/legalHolds/{legalholdId}
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
-
-|Property|Type|Description|
-|:|:|:|
-|contentQuery|String|KQL query that specifies content to be held in the specified locations. For more information about KQL in eDiscovery, see [Keyword queries and search conditions for Content Search and eDiscovery](/microsoft-365/compliance/keyword-queries-and-search-conditions). To hold all content in the specified locations, leave **contentQuery** blank. |
-|description|String| The legal hold description. |
-|displayName|String| The display name of the legal hold. |
-|isEnabled|Boolean|Indicates whether the hold is enabled and actively holding content. |
-
-## Response
-
-If successful, this action returns a `204 No Content` response code.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "update_legalhold"
-}
>-
-``` http
-PATCH https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/legalHolds/{legalholdId}
-Content-Type: application/json
-Content-length: 295
-
-{
- "description": "This is a description for a legalHold"
-}
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.legalHold"
-}
>-
-``` http
-HTTP/1.1 204 No Content
-```
v1.0 Ediscovery Reviewset Addtoreviewset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-reviewset-addtoreviewset.md
- Title: "reviewSet: addToReviewSet"
-description: "Start the process of adding a collection from Microsoft 365 services to a review set."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# reviewSet: addToReviewSet
-
-Namespace: microsoft.graph.ediscovery
--
-Start the process of adding a collection from Microsoft 365 services to a review set. After the operation is created, you can get the status of the operation by retrieving the `Location` parameter from the response headers. The location provides a URL that will return a [caseExportOperation](../resources/ediscovery-caseexportoperation.md).
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-POST /compliance/ediscovery/cases/{caseId}/reviewSets/{reviewsetId}/addToReviewSet
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply JSON representation of the parameters.
-
-The following table shows the parameters that can be used with this action.
-
-|Parameter|Type|Description|
-|:|:|:|
-|sourceCollection|[microsoft.graph.ediscovery.sourceCollection](../resources/ediscovery-sourcecollection.md)|The ID of the **sourceCollection**.|
-|additionalData|[microsoft.graph.ediscovery.dataCollectionScope](../resources/ediscovery-addtoreviewsetoperation.md#datacollectionscope-values)|The **dataCollectionScope** that will be included with the collection.|
-
-## Response
-
-If successful, this action returns a `202 Accepted` response code.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "reviewset_addtoreviewset"
-}
>-
-``` http
-POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/080e8cad-f21f-4452-8826-0ddf7e949fdd/reviewSets/6fe25d32-8167-4625-b75c-c4181ccbd9d5/addToReviewSet
-Content-Type: application/json
-Content-length: 531
-
-{
- "sourceCollection": {
- "id": "1a9b4145d8f84e39bc45a7f68c5c5119"
- },
- "additionalData": "linkedFiles"
-}
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>-
-``` http
-HTTP/1.1 202 Accepted
-```
v1.0 Ediscovery Reviewset Export https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-reviewset-export.md
- Title: "reviewSet: export"
-description: "Initiate an export from a reviewSet."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# reviewSet: export
-
-Namespace: microsoft.graph.ediscovery
--
-Initiate an export from a **reviewSet**. For details, see [Export documents from a review set in Advanced eDiscovery](/microsoft-365/compliance/export-documents-from-review-set).
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-POST /compliance/ediscovery/cases/{caseId}/reviewsets/{reviewsetId}/export
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|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|
-|:|:|:|
-|outputName|String| Name of the export. Required. |
-|description|String| Description of the export |
-|azureBlobContainer|String| When exporting to your own Azure storage account, this is the container URL. |
-|azureBlobToken|String| When exporting to your own Azure storage account, SAS token for the container URL. |
-|exportOptions| [microsoft.graph.ediscovery.exportOptions](../resources/ediscovery-caseexportoperation.md#exportoptions-values) |Specifies options that control the format of the export. Possible values are: `originalFiles`, `text`, `pdfReplacement`, `fileInfo`, `tags`.|
-|exportStructure|[microsoft.graph.ediscovery.exportFileStructure](../resources/ediscovery-caseexportoperation.md#exportfilestructure-values)| Options that control file structure and packaging of the export. Possible values are: `none`, `directory`, `pst`.|
-
-## Response
-
-If the export is started successfully, this action returns a `202 Accepted` response code. The response will also contain a `Location` header, which contains the location of the [caseExportOperation](../resources/ediscovery-caseexportoperation.md) that was created to handle the export. Check the status of the export operation by making a GET request to the location, when successfully completed, the [status](../resources/ediscovery-caseoperation.md#caseoperationstatus-values) will change to `succeeded`.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "reviewset_export"
-}
>-
-``` http
-POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/99e865fc-e29f-479a-ba83-9e58eb017103/reviewsets/e44ac2cb-f8b4-4fd8-aa1c-1391b46ba9cc/export
-Content-Type: application/json
-Content-length: 186
-
-{
- "outputName": "2020-12-06 Contoso investigation export",
- "description": "Export for the Contoso investigation",
- "exportOptions": "originalFiles,fileInfo,tags",
- "exportStructure": "directory"
-}
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>-
-``` http
-HTTP/1.1 202 Accepted
-cache-control: no-cache,
-client-request-id: 3ec98906-7187-927e-5203-2ed4533175c6,
-location: https://graph.microsoft.com/beta/compliance/ediscovery/cases('5b840b94-f821-4c4a-8cad-3a90062bf51a')/operations('2ad2da7c7dbb404abfbbb28b7b6babd6'),
-request-id: 9e6b9230-113c-49de-8f7d-ecb90d35b0de
-```
v1.0 Ediscovery Reviewsetquery Applytags https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-reviewsetquery-applytags.md
- Title: "reviewSetQuery: applyTags"
-description: "Apply tags to documents that match the specified query."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# reviewSetQuery: applyTags
-
-Namespace: microsoft.graph.ediscovery
--
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-POST /compliance/ediscovery/cases/{caseId}/reviewSets/{reviewSetId}/queries/{reviewSetQueryId}/applyTags
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply JSON representation of the parameters.
-
-The following table shows the parameters that can be used with this action.
-
-|Parameter|Type|Description|
-|:|:|:|
-|tagsToAdd|[microsoft.graph.ediscovery.tag](../resources/ediscovery-tag.md) collection|IDs of tags to add to the documents that match the query.|
-|tagsToRemove|[microsoft.graph.ediscovery.tag](../resources/ediscovery-tag.md) collection|IDs of tags to remove from the documents that match the query.|
-
-## Response
-
-If successful, this action returns a `202 Accepted` response code.
-
-If the tagging operation is started successfully, this action returns a `202 Accepted` response code. The response will also contain a `Location` header, which contains the location of the [tagOperation](../resources/ediscovery-tagOperation.md) that was created to handle the tagging. Check the status of the tagging operation by making a GET request to the location, when successfully completed, the [status](../resources/ediscovery-caseoperation.md#caseoperationstatus-values) will change to `succeeded`.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "reviewsetquery_applytags"
-}
>-
-``` http
-POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/reviewsets/6c95c2a6-31fa-45a8-93ef-dd4531974783/queries/b4798d14-748d-468e-a1ec-96a2b1d49677/applyTags
-Content-Type: application/json
-Content-length: 778
-
-{
- "tagsToAdd": [
- {
- "id": "b4798d14-748d-468e-a1ec-96a2b1d49677"
- }
- ]
-}
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>-
-``` http
-HTTP/1.1 202 Accepted
-cache-control: no-cache,
-client-request-id: 56c9dd8b-d8f7-59ae-6733-38191862c9c9,
-location: https://graph.microsoft.com/beta/compliance/ediscovery/cases('47746044-fd0b-4a30-acfc-5272b691ba5b')/operations('d77f7933e88842bab3221e280be9dc0b'),
-request-id: c2397a81-e9c2-4851-b669-d87e0751e45a
-```
v1.0 Ediscovery Sourcecollection Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-sourcecollection-delete.md
- Title: "Delete sourceCollection"
-description: "Delete a sourceCollection object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Delete sourceCollection
-
-Namespace: microsoft.graph.ediscovery
--
-Delete a [sourceCollection](../resources/ediscovery-sourcecollection.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-DELETE /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `204 No Content` response code.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "delete_sourcecollection"
-}
>-
-``` http
-DELETE https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>-
-``` http
-HTTP/1.1 204 No Content
-```
v1.0 Ediscovery Sourcecollection Estimatestatistics https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-sourcecollection-estimatestatistics.md
- Title: "sourceCollection: estimateStatistics"
-description: "Runs an estimate of the source collection."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# sourceCollection: estimateStatistics
-
-Namespace: microsoft.graph.ediscovery
--
-Run an estimate of the number of emails and documents in the source collection. To learn more about source collections (also known as searches in eDiscovery), see [Collect data for a case in Advanced eDiscovery](https://docs.microsoft.com/microsoft-365/compliance/collecting-data-for-ediscovery).
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-POST /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/estimateStatistics
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If the estimate is started successfully, this action returns a `202 Accepted` response code. The response will also contain a `Location` header, which contains the location of the [estimateStatisticsOperation](../resources/ediscovery-estimatestatisticsoperation.md) that was created to handle the estimate. Check the status of the estimate operation by making a GET request to the location, when successfully completed, the [status](../resources/ediscovery-caseoperation.md#caseoperationstatus-values) will change to `succeeded`.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "sourcecollection_estimatestatistics"
-}
>-
-``` http
-POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/estimateStatistics
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>-
-``` http
-HTTP/1.1 202 Accepted
-cache-control: private
-client-request-id: af32de50-99d9-e3a8-371b-a4f366cc78e7
-content-length: 0
-content-type: text/plain
-location: https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/operations/82edd40e182a464fa02c24a36fa94873
-request-id: e890176f-640f-4222-9cd8-be26e71c5e5d
-```
v1.0 Ediscovery Sourcecollection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-sourcecollection-get.md
- Title: "Get sourceCollection"
-description: "Read the properties and relationships of a sourceCollection object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get sourceCollection
-
-Namespace: microsoft.graph.ediscovery
--
-Read the properties and relationships of a [sourceCollection](../resources/ediscovery-sourcecollection.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-Use `$expand` to expand review set operations, custodian sources, and the last estimate statistics operation.
-
-```http
-https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/sourcecollections/1a9b4145d8f84e39bc45a7f68c5c5119?$expand=addToReviewSetOperation,custodianSources,lastEstimateStatisticsOperation
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a [microsoft.graph.ediscovery.sourceCollection](../resources/ediscovery-sourcecollection.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "get_sourcecollection"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/sourcecollections/1a9b4145d8f84e39bc45a7f68c5c5119?$expand=addToReviewSetOperation,custodianSources,lastEstimateStatisticsOperation
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.sourceCollection"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('47746044-fd0b-4a30-acfc-5272b691ba5b')/sourceCollections/$entity",
- "description": null,
- "lastModifiedDateTime": "2021-01-12T18:09:03.7378679Z",
- "contentQuery": "subject:'Quarterly Financials'",
- "tenantSources": "none",
- "id": "1a9b4145d8f84e39bc45a7f68c5c5119",
- "displayName": "Quarterly Financials search",
- "createdDateTime": "2021-01-12T18:09:03.417009Z",
- "createdBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": "EDisco Admin",
- "userPrincipalname": "admin@contoso.com"
- }
- },
- "lastModifiedBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": "EDisco Admin",
- "userPrincipalname": "admin@contoso.onmicrosoft.com"
- }
- },
- "addToReviewSetOperation": {
- "createdDateTime": "2021-01-13T05:38:49.9186654Z",
- "completedDateTime": "2021-01-13T07:54:45.0007868Z",
- "percentProgress": 100,
- "status": "succeeded",
- "action": "addToReviewSet",
- "id": "aef586b34d89405d802497658a14194f",
- "createdBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": null,
- "userPrincipalName": "admin@contoso.com"
- }
- }
- },
- "lastEstimateStatisticsOperation": {
- "createdDateTime": "2021-01-12T21:53:50.7272654Z",
- "completedDateTime": "2021-01-12T21:54:49.5595543Z",
- "percentProgress": 100,
- "status": "succeeded",
- "action": "estimateStatistics",
- "id": "f3db0382af0842eaa98c7dd59e7dace6",
- "indexedItemCount": 39598,
- "indexedItemsSize": 3760920737,
- "unindexedItemCount": 0,
- "unindexedItemsSize": 0,
- "mailboxCount": 1,
- "siteCount": 1,
- "createdBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": "EDisco Admin",
- "userPrincipalName": "admin@contoso.com"
- }
- }
- }
-}
-```
v1.0 Ediscovery Sourcecollection List Additionalsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-sourcecollection-list-additionalsources.md
- Title: "List additionalSources"
-description: "Get a list of additional dataSource objects associated with a source collection."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List additionalSources
-
-Namespace: microsoft.graph.ediscovery
--
-Get a list of additional [dataSource](../resources/ediscovery-datasource.md) objects associated with a source collection.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/additionalSources
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.ediscovery.dataSource](../resources/ediscovery-datasource.md) objects in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_datasource"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/additionalSources
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.dataSource)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.ediscovery.dataSource",
- "id": "0fb67fc5-7fc5-0fb6-c57f-b60fc57fb60f",
- "displayName": "String",
- "createdDateTime": "String (timestamp)",
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- }
- }
- ]
-}
-```
v1.0 Ediscovery Sourcecollection List Addtoreviewsetoperation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-sourcecollection-list-addtoreviewsetoperation.md
- Title: "List addToReviewSetOperation"
-description: "Get the last addToReviewSetOperation object associated with a source collection."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List addToReviewSetOperation
-
-Namespace: microsoft.graph.ediscovery
--
-Get the last [addToReviewSetOperation](../resources/ediscovery-addtoreviewsetoperation.md) object associated with a source collection.
-
->**Note:** This method only lists the last operation; it does not return a history of all operations.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/addToReviewSetOperation
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a [microsoft.graph.ediscovery.addToReviewSetOperation](../resources/ediscovery-addtoreviewsetoperation.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_addtoreviewsetoperation"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/sourceCollections/1a9b4145d8f84e39bc45a7f68c5c5119/addToReviewSetOperation
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.addToReviewSetOperation)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.ediscovery.addToReviewSetOperation",
- "id": "9055c657-c657-9055-57c6-559057c65590",
- "createdDateTime": "String (timestamp)",
- "completedDateTime": "String (timestamp)",
- "percentProgress": "Integer",
- "status": "String",
- "action": "String",
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "resultInfo": {
- "@odata.type": "microsoft.graph.resultInfo"
- }
- }
- ]
-}
-```
v1.0 Ediscovery Sourcecollection List Custodiansources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-sourcecollection-list-custodiansources.md
- Title: "List custodianSources"
-description: "Get the list of dataSource objects associated with a source collection."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List custodianSources
-
-Namespace: microsoft.graph.ediscovery
--
-Get the list of [dataSource](../resources/ediscovery-datasource.md) objects associated with a source collection.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/custodianSources
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.ediscovery.dataSource](../resources/ediscovery-datasource.md) objects in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_datasource"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/custodianSources
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.dataSource)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.ediscovery.dataSource",
- "id": "0fb67fc5-7fc5-0fb6-c57f-b60fc57fb60f",
- "displayName": "String",
- "createdDateTime": "String (timestamp)",
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- }
- }
- ]
-}
-```
v1.0 Ediscovery Sourcecollection List Lastestimatestatisticsoperation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-sourcecollection-list-lastestimatestatisticsoperation.md
- Title: "List estimateStatisticsOperation"
-description: "Get the last estimateStatisticsOperation object associated with a source collection."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List estimateStatisticsOperation
-
-Namespace: microsoft.graph.ediscovery
--
-Get the last [estimateStatisticsOperation](../resources/ediscovery-estimatestatisticsoperation.md) object associated with a source collection.
-
->**Note:** This method only lists the last operation; it does not return a history of all operations.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/lastEstimateStatisticsOperation
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a [microsoft.graph.ediscovery.estimateStatisticsOperation](../resources/ediscovery-estimatestatisticsoperation.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_estimatestatisticsoperation"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/sourceCollections/95bdbf84f02f4bdaafbbb2fe945a4962/lastEstimateStatisticsOperation
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.estimateStatisticsOperation)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "value": [
- {
- "createdDateTime": "2021-01-12T20:12:01.4443402Z",
- "completedDateTime": "2021-01-12T20:12:35.4818899Z",
- "percentProgress": 100,
- "status": "succeeded",
- "action": "estimateStatistics",
- "id": "95bdbf84f02f4bdaafbbb2fe945a4962",
- "indexedItemCount": 3,
- "indexedItemsSize": 68848,
- "unindexedItemCount": 0,
- "unindexedItemsSize": 0,
- "mailboxCount": 2,
- "siteCount": 0
- }
- ]
-}
-```
v1.0 Ediscovery Sourcecollection Post Additionalsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-sourcecollection-post-additionalsources.md
- Title: "Create dataSource"
-description: "Add additional data sources to a source collection."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create dataSource
-
-Namespace: microsoft.graph.ediscovery
--
-Add additional data sources to a source collection.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-POST /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/additionalSources
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply a JSON representation of the [dataSource](../resources/ediscovery-datasource.md) object.
-
-The following table shows the properties that are required when you create the [dataSource](../resources/ediscovery-datasource.md).
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|The ID for [sourceCollection](../resources/ediscovery-sourcecollection.md) case. Read-only. Inherited from [entity](../resources/entity.md)|
-|displayName|String|The name of the [sourceCollection](../resources/ediscovery-sourcecollection.md)|
-|createdDateTime|DateTimeOffset|The date and time when the [sourceCollection](../resources/ediscovery-sourcecollection.md) was created.|
-|createdBy|[identitySet](../resources/identityset.md)|The user who created the [sourceCollection](../resources/ediscovery-sourcecollection.md).|
-
-## Response
-
-If successful, this method returns a `201 Created` response code and a [microsoft.graph.ediscovery.dataSource](../resources/ediscovery-datasource.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "create_datasource_from_"
-}
>-
-``` http
-POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/additionalSources
-Content-Type: application/json
-Content-length: 179
-
-{
- "@odata.type": "#microsoft.graph.ediscovery.userSource",
- "email": "badguy@contoso.com"
-}
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.dataSource"
-}
>-
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-
-{
- "@odata.type": "#microsoft.graph.ediscovery.dataSource",
- "id": "0fb67fc5-7fc5-0fb6-c57f-b60fc57fb60f",
- "displayName": "String",
- "createdDateTime": "String (timestamp)",
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- }
-}
-```
v1.0 Ediscovery Sourcecollection Post Custodiansources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-sourcecollection-post-custodiansources.md
- Title: "Add custodianSources"
-description: "Add custodial dataSource objects to a source collection."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Add custodianSources
-
-Namespace: microsoft.graph.ediscovery
--
-Add custodian [dataSource](../resources/ediscovery-datasource.md) objects to a source collection.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-POST /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/custodianSources/$ref
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply a JSON representation of the [dataSource](../resources/ediscovery-datasource.md) object.
-
-The following table shows the properties that are required when you create the [dataSource](../resources/ediscovery-datasource.md).
-
-|Property|Type|Description|
-|:|:|:|
-|@odata.id|String|String that defines the custodial object. See the example that follows.|
-
-## Response
-
-If successful, this method returns a `204 No Content` response code and a [microsoft.graph.ediscovery.dataSource](../resources/ediscovery-datasource.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "create_datasource_from_"
-}
>-
-``` http
-POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/sourceCollections/1a9b4145d8f84e39bc45a7f68c5c5119/custodianSources/$ref
-Content-Type: application/json
-Content-length: 179
-
-{
- "@odata.id":"https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/custodians/ab3a628a383045eba344b3caecba3104/userSources/31423539-3846-4333-4136-353644383531"
-}
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.dataSource"
-}
>-
-``` http
-HTTP/1.1 204 No Content
-Content-Type: application/json
-```
v1.0 Ediscovery Sourcecollection Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-sourcecollection-update.md
- Title: "Update sourceCollection"
-description: "Update the properties of a sourceCollection object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update sourceCollection
-
-Namespace: microsoft.graph.ediscovery
--
-Update the properties of a [sourceCollection](../resources/ediscovery-sourcecollection.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-PATCH /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
-
-|Property|Type|Description|
-|:|:|:|
-|contentQuery|String|The query string in KQL (Keyword Query Language) query. For details, see [Keyword queries and search conditions for Content Search and eDiscovery](/microsoft-365/compliance/keyword-queries-and-search-conditions). You can refine searches by using fields paired with values; for example, `subject:"Quarterly Financials" AND Date>=06/01/2016 AND Date<=07/01/2016`.|
-|description|String|The description of the **sourceCollection**.|
-|displayName|String|The display name of the **sourceCollection**.|
-|tenantSources|microsoft.graph.ediscovery.tenantSources|When specified, the collection will span across a service for an entire workload. Possible values are: `allMailboxes`, `allSites`.|
-
-## Response
-
-If successful, this action returns a `204 No Content` response code.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "update_sourcecollection"
-}
>-
-``` http
-PATCH https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/sourceCollections/1a9b4145d8f84e39bc45a7f68c5c5119
-Content-Type: application/json
-Content-length: 247
-
-{
- "displayName": "Quarterly Financials search",
-}
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>-
-``` http
-HTTP/1.1 204 No Content
-```
v1.0 Ediscovery Tag Ashierarchy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-tag-ashierarchy.md
- Title: "tag: asHierarchy"
-description: "Return a list of tags in hierarchial form."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# tag: asHierarchy
-
-Namespace: microsoft.graph.ediscovery
--
-Return a list of [tag](../resources/ediscovery-tag.md) objects in hierarchial form
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/tags/asHierarchy
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this function returns a `200 OK` response code and a [microsoft.graph.ediscovery.tag](../resources/ediscovery-tag.md) collection in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "tag_ashierarchy"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/tags/asHierarchy
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.tag)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.ediscovery.tag",
- "id": "String (identifier)",
- "displayName": "String",
- "description": "String",
- "childSelectability": "String",
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "lastModifiedDateTime": "String (timestamp)"
- }
- ]
-}
-```
v1.0 Ediscovery Tag Childtags https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-tag-childtags.md
- Title: "List childTags"
-description: "Get a list of child [tag] objects associated with a tag."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List childTags
-
-Namespace: microsoft.graph.ediscovery
--
-Get a list of child [tag](../resources/ediscovery-tag.md) objects associated with a tag.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/tags/{tagId}/childTags
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.ediscovery.tag](../resources/ediscovery-tag.md) objects in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "list_tag"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/tags/e54b3f535b434a9a8743b84e34c00504/childTags
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "Collection(microsoft.graph.ediscovery.tag)"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.ediscovery.tag)",
- "value": [
- {
- "displayName": "Yes",
- "description": "The document is responsive",
- "lastModifiedDateTime": "2021-01-11T19:32:22.4091161Z",
- "childSelectability": "One",
- "id": "081ff31e7324423186e01b549efe7033",
- "createdBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": "EDisco Admin",
- "userPrincipalName": "admin@contoso.com"
- }
- },
- "childTags": []
- },
- {
- "displayName": "No",
- "description": "The document is not responsive",
- "lastModifiedDateTime": "2021-01-11T19:32:21.5693878Z",
- "childSelectability": "One",
- "id": "61624e6c96a64ccea40e0d2c48e23e16",
- "createdBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": "EDisco Admin",
- "userPrincipalName": "admin@contoso.com"
- }
- },
- "childTags": []
- }
- ]
-}
-```
v1.0 Ediscovery Tag Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-tag-delete.md
- Title: "Delete tag"
-description: "Delete a tag object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Delete tag
-
-Namespace: microsoft.graph.ediscovery
--
-Delete a [tag](../resources/ediscovery-tag.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-DELETE /compliance/ediscovery/cases/{caseId}/tags/{tagId}?forcedelete=true
-```
-
-## Query parameters
-
-In the request URL, provide the following required query parameter.
-
-| Parameter | Type | Description |
-|:--|:--|:--|
-| forcedelete | Boolean | If set to true, the tag and children will be deleted, if false, and the tag has children, the delete will fail. |
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `204 No Content` response code.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "delete_tag"
-}
>-
-``` http
-DELETE https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/tags/9985bd266f2f459cbebc81522734b452?forcedelete=true
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>-
-``` http
-HTTP/1.1 204 No Content
-```
v1.0 Ediscovery Tag Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-tag-get.md
- Title: "Get tag"
-description: "Read the properties and relationships of a tag object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get tag
-
-Namespace: microsoft.graph.ediscovery
--
-Read the properties and relationships of a [tag](../resources/ediscovery-tag.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /compliance/ediscovery/cases/{caseId}/tags/{tagId}
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a [microsoft.graph.ediscovery.tag](../resources/ediscovery-tag.md) object in the response body.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "get_tag"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/tags/e54b3f535b434a9a8743b84e34c00504
-```
-
-### Response
-
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.ediscovery.tag"
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('47746044-fd0b-4a30-acfc-5272b691ba5b')/tags/$entity",
- "displayName": "Responsiveness",
- "description": "Indicates the responsiveness of the document",
- "lastModifiedDateTime": "2021-01-11T19:32:23.1903658Z",
- "childSelectability": "One",
- "id": "e54b3f535b434a9a8743b84e34c00504",
- "createdBy": {
- "user": {
- "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
- "displayName": "EDisco Admin",
- "userPrincipalName": "admin@contoso.com"
- }
- },
- "childTags": []
-}
-```
v1.0 Ediscovery Tag Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-tag-update.md
- Title: "Update tag"
-description: "Update the properties of a tag object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update tag
-
-Namespace: microsoft.graph.ediscovery
--
-Update the properties of a [tag](../resources/ediscovery-tag.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|eDiscovery.Read.All, eDiscovery.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-PATCH /compliance/ediscovery/cases/{caseId}/tags/{tagId}
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
-
-|Property|Type|Description|
-|:|:|:|
-|description|String|The description for the tag.|
-|displayName|String|Display name of the tag.|
-
-## Response
-
-If successful, this method returns a `204 No Content` response code.
-
-## Examples
-
-### Request
-
-<!-- {
- "blockType": "request",
- "name": "update_tag"
-}
>-
-``` http
-PATCH https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/tags/e54b3f535b434a9a8743b84e34c00504
-Content-Type: application/json
-Content-length: 210
-
-{
- "description":"This is an updated description."
-}
-```
-
-### Response
-
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>-
-``` http
-HTTP/1.1 204 No Content
-```
v1.0 Ediscoverycase Close https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscoverycase-close.md
+
+ Title: "ediscoveryCase: close"
+description: "Close an eDiscovery case."
+
+localization_priority: Normal
++
+# ediscoveryCase: close
+
+Namespace: microsoft.graph
+
+Close an eDiscovery case. For details, see [Close a case](/microsoft-365/compliance/close-or-delete-case#close-a-case).
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST /compliance/ediscovery/cases/{ediscoveryCaseId}/close
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "ediscoverycase_close"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/061b9a92-8926-4bd9-b41d-abf35edc7583/close
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Ediscoverycase Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscoverycase-delete.md
+
+ Title: "Delete ediscoveryCase"
+description: "Delete an ediscoveryCase object."
+localization_priority: Normal
+++
+# Delete ediscoveryCase
++
+Delete an [ediscoveryCase](../resources/ediscoverycase.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | User.Read |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+DELETE /compliance/ediscovery/cases/{id}
+```
+
+## Request headers
+
+| Name | Description |
+|:--|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "delete_ediscoverycase"
+}-->
+
+```http
+DELETE https://graph.microsoft.com/beta/compliance/ediscovery/cases/061b9a92-8926-4bd9-b41d-abf35edc7583
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "Delete ediscoveryCase",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
++
v1.0 Ediscoverycase Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscoverycase-get.md
+
+ Title: "Get ediscoveryCase"
+description: "Retrieve the properties and relationships of ediscoverycase object."
+localization_priority: Normal
+++
+# Get ediscoveryCase
++
+Retrieve the properties and relationships of an [ediscoveryCase](../resources/ediscoverycase.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | User.Read |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /compliance/ediscovery/cases/{id}
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+| Name |Description|
+|:-|:-|
+| Authorization | Bearer {token} |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and the requested [ediscoveryCase](../resources/ediscoverycase.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+<!-- {
+ "blockType": "request",
+ "name": "get_ediscoverycase"
+}-->
+
+```http
+GET https://graph.microsoft.com/beta/cases/061b9a92-8926-4bd9-b41d-abf35edc7583
+```
+
+### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.ediscoveryCase"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "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": ""
+}
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "Get ediscoveryCase",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
+
v1.0 Ediscoverycase List Custodians https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscoverycase-list-custodians.md
+
+ Title: "List custodians"
+description: "Get a list of the custodian objects and their properties."
+
+localization_priority: Normal
++
+# List custodians
+
+Namespace: microsoft.graph
++
+Get a list of the [custodian](../resources/custodian.md) objects and their properties.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /compliance/ediscovery/cases/{ediscoveryCaseId}/custodians
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [custodian](../resources/custodian.md) objects in the response body.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_custodian"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/2192ca408ea2410eba3bec8ae873be6b/custodians
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.custodian)"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('4c8f8f70-7785-4bd4-b296-c98376a2c5e1')/custodians",
+ "value": [
+ {
+ "email": "meganb@contoso.com",
+ "applyHoldToSources": false,
+ "status": "released",
+ "createdDateTime": "2020-10-27T15:55:43.4971108Z",
+ "lastModifiedDateTime": "2020-10-30T05:34:00.947558Z",
+ "releasedDateTime": "2020-10-27T15:55:58.2338864Z",
+ "acknowledgedDateTime": null,
+ "id": "fd03ce02ecde42a58d24fcbc9ebbea3e",
+ "displayName": "Megan Bowen"
+ },
+ {
+ "email": "AdeleV@contoso.com",
+ "applyHoldToSources": true,
+ "status": "active",
+ "createdDateTime": "2020-08-21T13:20:02.0117254Z",
+ "lastModifiedDateTime": "2020-10-27T15:14:14.1244649Z",
+ "releasedDateTime": null,
+ "acknowledgedDateTime": null,
+ "id": "2192ca408ea2410eba3bec8ae873be6b",
+ "displayName": "Adele Vance"
+ }
+ ]
+}
+```
v1.0 Ediscoverycase List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscoverycase-list.md
+
+ Title: "List ediscoveryCases"
+description: "Retrieve a list of eDiscovery cases."
+localization_priority: Normal
+++
+# List ediscoveryCases
++
+Retrieve a list of [ediscoveryCase](../resources/ediscoverycase.md) objects.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | User.Read |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /compliance/ediscovery/cases
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+| Name |Description|
+|:-|:-|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [ediscoveryCase](../resources/ediscoverycase.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_ediscoverycase"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/compliance/ediscovery/cases
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.ediscoveryCase",
+ "isCollection": true
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#cases",
+ "odata.nextLink":"https://graph.microsoft.com/beta/compliance/ediscovery/cases?$skipToken=159dc1d7-f84f-439e-9d57-4a4d3af0abe5",
+ "value": [
+ {
+ "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": ""
+ },
+ {
+ "id": "b956a1b5-6b74-47db-af83-97d1fdad4ddc",
+ "displayName": "My Case 2",
+ "description": "",
+ "createdBy": {
+ "user": {
+ "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
+ "displayName": "eDiscovery admin"
+ }
+ },
+ "createdDateTime": "2020-02-18T22:42:28.5505500Z",
+ "lastModifiedBy": {
+ "user": {
+ "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
+ "displayName": "eDiscovery admin"
+ }
+ },
+ "lastModifiedDateTime": "2020-02-18T22:42:28.5505500Z",
+ "status": "active",
+ "closedBy": null,
+ "closedDateTime": null,
+ "externalId": ""
+ }
+ ]
+}
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "List cases",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
++
v1.0 Ediscoverycase Post Custodians https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscoverycase-post-custodians.md
+
+ Title: "Create custodian"
+description: "Create a new custodian object."
+
+localization_priority: Normal
++
+# Create custodian
+
+Namespace: microsoft.graph
++
+Create a new [custodian](../resources/custodian.md) object. After the custodian object is created, you will need to create the custodian's [userSource](../resources/usersource.md) to reference their mailbox and OneDrive for Business site.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST /compliance/ediscovery/cases/{ediscoveryCaseId}/custodians
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the [custodian](../resources/custodian.md) object.
+
+The following table shows the properties that are required when you create the [custodian](../resources/custodian.md).
+
+|Property|Type|Description|
+|:|:|:|
+|email|String|Custodian's primary SMTP address. Required.|
+|applyHoldToSources|Boolean|Indicates whether a hold is applied to the custodian's sources (such as mailboxes, sites, or Teams).|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [custodian](../resources/custodian.md) object in the response body.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_custodian_from_"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/2192ca408ea2410eba3bec8ae873be6b/custodians
+Content-Type: application/json
+Content-length: 279
+
+{
+ "email":"AdeleV@contoso.com",
+ "applyHoldToSources":"true"
+}
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.custodian"
+}
+-->
+
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases('4c8f8f70-7785-4bd4-b296-c98376a2c5e1')/custodians/$entity",
+ "email": "AdeleV@contoso.com",
+ "applyHoldToSources": false,
+ "status": "active",
+ "createdDateTime": "2020-10-30T20:47:01.7724531Z",
+ "lastModifiedDateTime": "2020-10-30T20:47:02.2512381Z",
+ "releasedDateTime": null,
+ "acknowledgedDateTime": null,
+ "id": "45353243323138344430413038363846",
+ "displayName": "Adele Vance"
+}
+```
v1.0 Ediscoverycase Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscoverycase-post.md
+
+ Title: "Create ediscoveryCase"
+description: "Use this API to create a new ediscoveryCase."
+localization_priority: Normal
+++
+# Create ediscoveryCase
++
+Create a new [ediscoveryCase](../resources/ediscoverycase.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | User.Read |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+POST /compliance/ediscovery/cases
+```
+
+## Request headers
+
+| Name | Description |
+|:--|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+
+In the request body, supply a JSON representation of an [ediscoveryCase](../resources/ediscoverycase.md) object. The following table lists properties that can be submitted with the call.
+
+| Property | Type | Description |
+|:-|:|:|
+| displayName | string | The name of the eDiscovery case. |
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a new [ediscoveryCase](../resources/ediscoverycase.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "post_ediscoverycase"
+}-->
+
+```http
+POST https://graph.microsoft.com/beta/compliance/ediscovery/cases
+Content-type: application/json
+
+{
+ "displayName": "My Case 1",
+}
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.ediscoveryCase"
+} -->
+
+```http
+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": ""
+}
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "Create ediscoveryCase",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
++
v1.0 Ediscoverycase Reopen https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscoverycase-reopen.md
+
+ Title: "ediscoveryCase: reopen"
+description: "Reopen an eDiscovery case that was closed."
+
+localization_priority: Normal
++
+# ediscoveryCase: reopen
+
+Namespace: microsoft.graph
+
+Reopen an eDiscovery case that was closed. For details, see [Reopen a closed case](/microsoft-365/compliance/close-or-delete-case#reopen-a-closed-case).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|User.Read|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST /compliance/ediscovery/cases/{ediscoveryCaseId}/reopen
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "ediscoverycase_reopen"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/061b9a92-8926-4bd9-b41d-abf35edc7583/reopen
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Ediscoverycase Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscoverycase-update.md
+
+ Title: "Update ediscoverycase"
+description: "Update the properties of an ediscoveryCase object."
+localization_priority: Normal
+++
+# Update ediscoveryCase
++
+Update the properties of an [ediscoveryCase](../resources/ediscoverycase.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | User.Read |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+PATCH /compliance/ediscovery/cases/{id}
+```
+
+## Request headers
+
+| Name | Description|
+|:--|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+
+In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+| Property | Type | Description |
+|:-|:|:|
+|description|String| The case description. |
+|displayName|String| The case name. |
+|externalId|String| The external case number for customer reference. |
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_ediscoverycase"
+}-->
+
+```http
+PATCH https://graph.microsoft.com/beta/compliance/ediscovery/cases/061b9a92-8926-4bd9-b41d-abf35edc7583
+Content-type: application/json
+
+{
+ "displayName": "My Case 1 - Renamed",
+ "description": "Updated description",
+ "externalId": "Updated externalId"
+}
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.ediscoveryCase"
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "Update ediscoverycase",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
++
v1.0 Educationassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignment-get.md
If successful, this method returns a `200 OK` response code and an [educationAss
## Example ##### Request The following is an example of the request.-
-# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "get_educationassignment" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/beta/education/classes/11014/assignments/19002 ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ##### Response The following is an example of the response. >**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. <!-- {
- "blockType": "response",
+ "blockType": "ignored",
"truncated": true, "@odata.type": "microsoft.graph.educationAssignment" } -->
Content-length: 279
"tocPath": "", "suppressions": [] }>
+-->
v1.0 Educationassignment List Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignment-list-resources.md
If successful, this method returns a `200 OK` response code and a collection of
## Example ##### Request The following is an example of the request.-
-# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "get_resources" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/beta/education/classes/11012/assignments/19002/resources ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ##### Response The following is an example of the response. >**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call. <!-- {
- "blockType": "response",
+ "blockType": "ignored",
"truncated": true, "@odata.type": "microsoft.graph.educationAssignmentResource", "isCollection": true
Content-length: 1011
"tocPath": "", "suppressions": [] }>
+-->
v1.0 Educationassignment List Submissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignment-list-submissions.md
If successful, this method returns a `200 OK` response code and collection of [e
## Example ##### Request The following is an example of the request.-
-# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "get_submissions" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/submissions ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ##### Response The following is an example of the response. >**Note:** The response object shown here might be shortened for readability. All of the properties will be returned from an actual call. <!-- {
- "blockType": "response",
+ "blockType": "ignored",
"truncated": true, "@odata.type": "microsoft.graph.educationSubmission", "isCollection": true
Content-length: 873
"tocPath": "", "suppressions": [] }>
+-->
v1.0 Educationassignmentdefaults Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignmentdefaults-get.md
- Title: "Get educationAssignmentDefaults"
-description: "Read the properties and relationships of an educationAssignmentDefaults object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get educationAssignmentDefaults
-Namespace: microsoft.graph
--
-Read the properties and relationships of an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object. These are the class-level assignment defaults respected by new assignments created in the class. Callers can continue to specify custom values on each assignment creation if they do not want the default behaviors.
-
-## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)| EduAssignments.ReadBasic, EduAssignments.ReadWriteBasic, EduAssignments.Read, EduAssignments.ReadWrite |
-|Delegated (personal Microsoft account)| Not supported. |
-|Application| Not supported. |
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /education/classes/{id}/assignmentDefaults
-```
-
-## Optional query parameters
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object in the response body.
-
-## Examples
-
-### Request
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_educationassignmentdefaults"
-}
>
-``` http
-GET https://graph.microsoft.com/beta/education/classes/{id}/assignmentDefaults
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-----
-### Response
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.educationAssignmentDefaults"
-}
>
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "value": {
- "addedStudentAction": "none",
- "dueTime": "23:59:00",
- "notificationChannelUrl": "https://graph.microsoft.com/beta/teams('id')/channels('id')"
- }
-}
-```
-
v1.0 Educationassignmentdefaults Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignmentdefaults-update.md
- Title: "Update educationAssignmentDefaults"
-description: "Update the properties of an educationAssignmentDefaults object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update educationAssignmentDefaults
-Namespace: microsoft.graph
--
-Update the properties of an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object. Only teachers can update these settings.
-
-## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account) | EduAssignments.ReadWriteBasic, EduAssignments.ReadWrite |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-PATCH /education/classes/{id}/assignmentDefaults
-```
-
-## Request headers
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required.|
-|Content-Type|application/json. Required.|
-
-## Request body
-In the request body, supply the values for relevant fields of the [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object that should be updated. Existing properties that are not included in the request body will maintain their previous values. For best performance, don't include existing values that haven't changed.
-
-|Property|Type|Description|
-|:|:|:|
-|addedStudentAction|educationAddedStudentAction|Class-level default behavior for handling students who are added after the assignment is published. Possible values are: `none`, `assignIfOpen`. The default value is `none`.|
-|dueTime|TimeOfDay|Class-level default value for due time field. Default value is `23:59:00`|
-|notificationChannelUrl|String|Default Teams channel to which notifications will be sent. Default value is `null`.|
---
-## Response
-
-If successful, this method returns a `200 OK` response code and an updated [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object in the response body.
-
-## Examples
-
-### Request
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "update_educationassignmentdefaults"
-}
>
-``` http
-PATCH https://graph.microsoft.com/beta/education/classes/{id}/assignmentDefaults
-Content-Type: application/json
-Content-length: 181
-
-{
- "addedStudentAction": "assignIfOpen",
- "notificationChannelUrl": "https://graph.microsoft.com/beta/teams('id')/channels('id')"
-}
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-----
-### Response
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.educationAssignmentDefaults"
-}
>
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "addedStudentAction": "assignIfOpen",
- "dueTime": "23:59:00",
- "notificationChannelUrl": "https://graph.microsoft.com/beta/teams('id')/channels('id')"
-}
-```
-
v1.0 Educationassignmentresource Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignmentresource-update.md
If successful, this method returns a `200 OK` response code and an updated [educ
## Example ##### Request The following is an example of the request.-
-# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "update_educationassignmentresource" }--> ```http
Content-length: 822
"distributeForStudentWork": "false" } ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ##### Response The following is an example of the response.
The following is an example of the response.
<!-- {
- "blockType": "response",
+ "blockType": "ignored",
"truncated": true, "@odata.type": "microsoft.graph.educationAssignmentResource" } -->
v1.0 Educationassignmentsettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignmentsettings-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|EduAssignments.ReadBasic, EduAssignments.ReadWriteBasic, EduAssignments.Read, EduAssignments.ReadWrite|
+|Delegated (work or school account)|EduAssignments.ReadWriteBasic, EduAssignments.ReadWrite|
|Delegated (personal Microsoft account)|Not supported.| |Application|Not supported.|
If successful, this method returns a `200 OK` response code and an [educationAss
## Examples ### Request-
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_educationassignmentsettings"
If successful, this method returns a `200 OK` response code and an [educationAss
``` http GET https://graph.microsoft.com/beta/education/classes/{id}/assignmentSettings ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response **Note:** The response object shown here might be shortened for readability.
v1.0 Educationassignmentsettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignmentsettings-update.md
If successful, this method returns a `200 OK` response code and an updated [educ
## Examples ### Request-
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_educationassignmentsettings"
Content-length: 114
"submissionAnimationDisabled": true } ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response
v1.0 Educationclass List Assignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationclass-list-assignments.md
Content-length: 344
"value": [ { "id": "19002",
- "addedStudentAction": "none",
+ "addedStudentAction": "String",
"allowLateSubmissions": true, "allowStudentsToAddResourcesToSubmission": true, "assignDateTime": "2014-02-01T00:00:00Z",
Content-length: 344
} }, "lastModifiedDateTime": "2014-02-01T00:00:00Z",
- "notificationChannelUrl": null,
+ "notificationChannelUrl": "String",
"status": "published" } ]