Updates from: 06/15/2022 02:54:44
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Authentication List Temporaryaccesspassmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-list-temporaryaccesspassmethods.md
+
+ Title: "List temporaryAccessPassMethods"
+description: "Get a list of the temporaryAccessPassAuthenticationMethod objects for a user."
+
+ms.localizationpriority: medium
++
+# List temporaryAccessPassMethods
+Namespace: microsoft.graph
+++
+Retrieve a list of a user's [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) objects and their properties. This API will only return a single object in the collection as a user can have only one Temporary Access Pass method.
+
+## 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).
+
+### Permissions acting on self
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:-|
+| Delegated (work or school account) | UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+### 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 |
++
+For delegated scenarios where an admin is acting on another user, the admin needs one of the following [roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+
+* Global administrator
+* Global reader
+* Privileged authentication administrator
+* Authentication administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /me/authentication/temporaryAccessPassMethods
+GET /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods
+```
+
+## Optional query parameters
+This method does not support optional query parameters to customize the response.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) objects in the response body. This call will only return a single object because only one **temporaryAccessPassAuthenticationMethod** can be set on users.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "list_temporaryaccesspassauthenticationmethod"
+}
+-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.temporaryAccessPassAuthenticationMethod)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('071cc716-8147-4397-a5ba-b2105951cc0b')/authentication/temporaryAccessPassMethods",
+ "value": [
+ {
+ "id": "bdaede67-61e0-4349-9347-d2d6afd84009",
+ "temporaryAccessPass": null,
+ "createdDateTime": "2022-06-06T16:43:04.6438213Z",
+ "startDateTime": "2022-06-06T16:48:03.027Z",
+ "lifetimeInMinutes": 60,
+ "isUsableOnce": false,
+ "isUsable": false,
+ "methodUsabilityReason": "NotYetValid"
+ }
+ ]
+}
+```
v1.0 Authentication Post Temporaryaccesspassmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-post-temporaryaccesspassmethods.md
+
+ Title: "Create temporaryAccessPassMethod"
+description: "Create a new temporaryAccessPassAuthenticationMethod object for a user."
+
+ms.localizationpriority: medium
++
+# Create temporaryAccessPassMethod
+Namespace: microsoft.graph
+++
+Create a new [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object on a user. A user can only have one Temporary Access Pass that's usable within its specified lifetime. If the user requires a new Temporary Access Pass while the current Temporary Access Pass is valid, the admin can create a new Temporary Access Pass for the user, the previous Temporary Access Pass will be deleted, and a new Temporary Access Pass will be created.
+
+## 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).
+
+### Permissions acting on other users
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:-|
+| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | UserAuthenticationMethod.ReadWrite.All |
+
+For delegated scenarios where an admin is acting on another user, the admin needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+* Global administrator
+* Privileged authentication administrator
+* Authentication administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods
+```
+
+## 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 [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object.
+
+The following table describes optional properties that can be used when creating the [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md).
+
+|Property|Type|Description|
+|:|:|:|
+|isUsableOnce|Boolean|Optional. Determines if the pass is limited to a one-time use. If `true`, the pass can be used once; if `false`, the pass can be used multiple times within its **lifetimeInMinutes** setting. A multi-use Temporary Access Pass (`isUsableOnce = false`), can only be created and used for sign-in if it is allowed by the [Temporary Access Pass authentication method policy](../resources/temporaryaccesspassauthenticationmethodconfiguration.md).|
+|lifetimeInMinutes|Int32|Optional. The lifetime of the temporaryAccessPass in minutes starting at creation time or at startDateTime, if set. Must be between 10 and 43200 (equivalent to 30 days). If not specified, the **defaultLifetimeInMinutes** setting in the [Temporary Access Pass authentication method policy](../resources/temporaryaccesspassauthenticationmethodconfiguration.md) is applied. |
+|startDateTime|DateTimeOffset|Optional. The date and time when the temporaryAccessPass becomes available to use. If not specified, the Temporary Access Pass is available to use immediately after it's created.|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "create_temporaryaccesspassauthenticationmethod_from_"
+}
+-->
+```msgraph-interactive
+POST https://graph.microsoft.com/beta/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods
+Content-Type: application/json
+
+{
+ "startDateTime": "2022-06-05T00:00:00.000Z",
+ "lifetimeInMinutes": 60,
+ "isUsableOnce": false
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.temporaryAccessPassAuthenticationMethod"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
+ "id": "6f1967b7-15e8-4935-ac26-d50770ed07a7",
+ "temporaryAccessPass": "+drkzqAD",
+ "createdDateTime": "2022-06-02T16:21:09.765173Z",
+ "startDateTime": "2022-06-05T00:00:00Z",
+ "lifetimeInMinutes": 60,
+ "isUsableOnce": false,
+ "isUsable": false,
+ "methodUsabilityReason": "NotYetValid"
+}
+```
v1.0 Bookingstaffmember Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingstaffmember-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-bookingstaffmember-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+ ### Response
v1.0 Connectedorganization Delete Internalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/connectedorganization-delete-internalsponsors.md
DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+
v1.0 Directory Deleteditems Restore https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-restore.md
POST https://graph.microsoft.com/beta/directory/deleteditems/46cc6179-19d0-473e-
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+ ### Response
v1.0 Driveitem Checkin https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/driveitem-checkin.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+
v1.0 Driveitem Checkout https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/driveitem-checkout.md
POST /drives/{drive-id}/items/{item-id}/checkout
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+
v1.0 Governanceroleassignmentrequest Cancel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroleassignmentrequest-cancel.md
POST https://graph.microsoft.com/beta/privilegedAccess/azureResources/roleAssign
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+
v1.0 Governanceroleassignmentrequest Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroleassignmentrequest-update.md
POST https://graph.microsoft.com/beta/privilegedAccess/azureResources/roleAssign
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+ ##### Request body
v1.0 Invitation Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/invitation-post.md
If successful, this method returns `201 Created` response code and [invitation](
### Request The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_invitation_post"
Content-type: application/json
"inviteRedirectUrl": "https://myapp.contoso.com" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+++ ### Response
v1.0 Managedtenants Managedtenant List Myroles https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-myroles.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_myrole"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/myRoles ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Rbacapplication Post Roleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-post-roleassignments.md
Content-type: application/json
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Security Caseoperation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-caseoperation-get.md
If successful, this method returns a `200 OK` response code and a [caseOperation
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_caseoperation"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/operations/850c2f64b1ee44a4a69729327aac2b04 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Casesroot Delete Ediscoverycases https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-casesroot-delete-ediscoverycases.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_ediscoverycase"
The following is an example of a request.
``` http DELETE https://graph.microsoft.com/beta/security/cases/eDiscoverycases/22aa2acd-7554-4330-9ba9-ce20014aaae4 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response The following is an example of the response
The following is an example of the response
--> ``` http HTTP/1.1 204 No Content
-```
+```
v1.0 Security Casesroot List Ediscoverycases https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-casesroot-list-ediscoverycases.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_ediscoverycase"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/ediscoveryCases ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Casesroot Post Ediscoverycases https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-casesroot-post-ediscoverycases.md
If successful, this method returns a `201 Created` response code and an [ediscov
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_ediscoverycase_from_"
Content-Type: application/json
"externalId": "324516" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase Close https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-close.md
If successful, this action returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "close_ediscoverycase"
If successful, this action returns a `204 No Content` response code.
``` http POST https://graph.microsoft.com/security/cases/eDiscoveryCases/061b9a92-8926-4bd9-b41d-abf35edc7583/close ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase Delete Legalholds https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-delete-legalholds.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_ediscoveryholdpolicy"
The following is an example of a request.
``` http DELETE https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/legalholds/a4d3421d-b756-47ac-ad43-5d587c5dfe75/ ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase Delete Searches https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-delete-searches.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_ediscoverysearch"
The following is an example of a request.
``` http DELETE https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/searches/60150269-9758-4439-9bc4-453c864d082f ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase Delete Tags https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-delete-tags.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_parent_from_ediscoveryreviewtag"
The following is an example of a request.
``` http DELETE https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/tags/d05c2ef9369d49c293b5a6a6d18a5fd9 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-get.md
If successful, this method returns a `200 OK` response code and an [ediscoveryCa
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_ediscoverycase"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/22aa2acd-7554-4330-9ba9-ce20014aaae4 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
Content-Type: application/json
"lastModifiedBy": null, "closedBy": null }
-```
+```
v1.0 Security Ediscoverycase List Custodians https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-list-custodians.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_ediscoverycustodian_from_"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/custodians ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response The following is an example of the response
v1.0 Security Ediscoverycase List Legalholds https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-list-legalholds.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_ediscoveryholdpolicy"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/legalHolds ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase List Noncustodialdatasources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-list-noncustodialdatasources.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_ediscoverynoncustodialdatasource_from_"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/noncustodialdatasources?$expand=dataSource ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase List Operations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-list-operations.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_caseoperation"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/operations ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
Content-Type: application/json
} ] }
-```
+```
v1.0 Security Ediscoverycase List Reviewsets https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-list-reviewsets.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_ediscoveryreviewset"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/reviewSets ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase List Searches https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-list-searches.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_ediscoverysearch"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase List Tags https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-list-tags.md
If successful, this method returns a `200 OK` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_ediscoveryreviewtag_from_"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/tags ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
Content-Type: application/json
} ] }
-```
+```
v1.0 Security Ediscoverycase Post Custodians https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-post-custodians.md
If successful, this method returns a `201 Created` response code and an [ediscov
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_ediscoverycustodian_from_"
Content-Type: application/json
"email":"AdeleV@contoso.com", } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
Content-Type: application/json
"email": "AdeleV@contoso.com", "acknowledgedDateTime": "0001-01-01T00:00:00Z" }
-```
+```
v1.0 Security Ediscoverycase Post Legalholds https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-post-legalholds.md
If successful, this method returns a `201 Created` response code and an [ediscov
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_ediscoveryholdpolicy_from_"
Content-Type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
v1.0 Security Ediscoverycase Post Noncustodialdatasources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-post-noncustodialdatasources.md
If successful, this method returns a `201 Created` response code and an [ediscov
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_ediscoverynoncustodialdatasource_from_"
Content-Type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase Post Reviewsets https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-post-reviewsets.md
If successful, this method returns a `201 Created` response code and an [ediscov
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_ediscoveryreviewset_from_"
Content-Type: application/json
"displayName": "My review set 2" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase Post Searches https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-post-searches.md
If successful, this method returns a `201 Created` response code and an [ediscov
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_ediscoverysearch_from_"
Content-Type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycase Post Tags https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-post-tags.md
If successful, this method returns a `201 Created` response code and an [ediscov
### Create a tag #### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_ediscoveryreviewtag_from_"
POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-ce
"childSelectability": "Many" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ #### Response
Content-Type: application/json
} } }
-```
+```
v1.0 Security Ediscoverycase Reopen https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-reopen.md
If successful, this action returns a `204 No Content` response code.
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "reopen_ediscoverycase"
If successful, this action returns a `204 No Content` response code.
``` http POST https://graph.microsoft.com/security/cases/eDiscoveryCases/061b9a92-8926-4bd9-b41d-abf35edc7583/reopen ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response <!-- {
v1.0 Security Ediscoverycase Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-update.md
If successful, this method returns a `204 NO CONTENT` response code and an updat
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_ediscoverycase"
Content-Type: application/json
"description": "Updated description" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response The following is an example of the response
The following is an example of the response
--> ```http HTTP/1.1 204 No Content
-```
+```
v1.0 Security Ediscoverycasesettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycasesettings-get.md
If successful, this method returns a `200 OK` response code and an [ediscoveryCa
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_ediscoverycasesettings"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/settings ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycasesettings Resettodefault https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycasesettings-resettodefault.md
If successful, this action returns a `200 OK` response code.
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "settings_resettodefault"
If successful, this action returns a `200 OK` response code.
``` http POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/settings/resettodefault ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Security Ediscoverycasesettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycasesettings-update.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_ediscoverycasesettings"
Content-Type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
The following is an example of the response
--> ``` http HTTP/1.1 204 No Content
-```
+```
v1.0 Security Ediscoverycustodian Activate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-activate.md
If successful, this action returns a `202 Accepted` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverycustodianthis.activate"
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/{ediscoveryCaseId}/custodians/{ediscoveryCustodianId}/activate ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
The following is an example of the response
--> ``` http HTTP/1.1 202 Accepted
-```
+```
v1.0 Security Ediscoverycustodian Applyhold https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-applyhold.md
If successful, this action returns a `202 Accepted` response code.
### Example 1. Apply hold to multiple custodians. #### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverycustodianthis.applyhold"
Content-Type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ #### Response
HTTP/1.1 202 Accepted
### Example 2. Apply hold to a single custodian. #### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverycustodianthis.applyhold"
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/custodians/c25c3914f9f743ee9cbaa25377e0cec6/applyHold ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ #### Response
The following is an example of the response
--> ``` http HTTP/1.1 202 Accepted
-```
+```
v1.0 Security Ediscoverycustodian Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-get.md
If successful, this method returns a `200 OK` response code and an [ediscoveryCu
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_ediscoverycustodian"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/custodians/0053a61a3b6c42738f7606791716a22a ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
Content-Type: application/json
"email": "AlexW@M365x809305.OnMicrosoft.com", "acknowledgedDateTime": "0001-01-01T00:00:00Z" }
-```
+```
v1.0 Security Ediscoverycustodian List Lastindexoperation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-list-lastindexoperation.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_ediscoveryindexoperation"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/custodians/0053a61a3b6c42738f7606791716a22a/lastIndexOperation ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response The following is an example of the response
v1.0 Security Ediscoverycustodian List Sitesources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-list-sitesources.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_sitesource"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/custodians/0053a61a3b6c42738f7606791716a22a/siteSources ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+++ ### Response
Content-Type: application/json
} ] }
-```
+```
v1.0 Security Ediscoverycustodian List Unifiedgroupsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-list-unifiedgroupsources.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_unifiedgroupsource"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/custodians/0053a61a3b6c42738f7606791716a22a/unifiedGroupSources ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycustodian List Usersources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-list-usersources.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_usersource"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/custodians/0053a61a3b6c42738f7606791716a22a/userSources ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycustodian Post Sitesources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-post-sitesources.md
If successful, this method returns a `201 Created` response code and a [siteSour
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_sitesource_from_"
Content-Type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response The following is an example of the response
v1.0 Security Ediscoverycustodian Post Unifiedgroupsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-post-unifiedgroupsources.md
If successful, this method returns a `201 Created` response code and an [unified
### Example 1: Create unifiedGroupSource with group SMTP address #### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_unifiedgroupsource_from_"
Content-Type: application/json
"includedSources": "mailbox, site" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ #### Response
Content-Type: application/json
### Example 2: Create unifiedGroupSource with group@odata.bind #### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_unifiedgroupsource_from_"
Content-Type: application/json
"includedSources": "mailbox" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ #### Response
v1.0 Security Ediscoverycustodian Post Usersources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-post-usersources.md
If successful, this method returns a `201 Created` response code and a [userSour
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_usersource_from_"
POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-41
"includedSources": "mailbox, site" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverycustodian Release https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-release.md
If successful, this action returns a `202 Accepted` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverycustodianthis.release"
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/custodians/c25c3914f9f743ee9cbaa25377e0cec6/release ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
The following is an example of the response
--> ``` http HTTP/1.1 202 Accepted
-```
+```
v1.0 Security Ediscoverycustodian Removehold https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-removehold.md
If successful, this action returns a `202 Accepted` response code.
### Example 1. Apply hold to multiple custodians. #### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverycustodianthis.removehold"
Content-Type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ #### Response
HTTP/1.1 202 Accepted
### Example 2. Apply hold to a single custodian. #### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverycustodianthis.removehold"
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/custodians/c25c3914f9f743ee9cbaa25377e0cec6/removeHold ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ #### Response
The following is an example of the response
--> ``` http HTTP/1.1 202 Accepted
-```
+```
v1.0 Security Ediscoverycustodian Updateindex https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycustodian-updateindex.md
If successful, this action returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverycustodianthis.updateindex"
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/custodians/c25c3914f9f743ee9cbaa25377e0cec6/updateIndex ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryfile Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryfile-get.md
If successful, this method returns a `200 OK` response code and an [ediscoveryFi
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_ediscoveryfile"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/files/000168cdf05c48d98faac7bff8719726a25da40bb2b9c369fb580b8797abf661 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryholdpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryholdpolicy-get.md
If successful, this method returns a `200 OK` response code and an [ediscoveryHo
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_ediscoveryholdpolicy"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/legalholds/783c3ea4-d474-4051-9c13-08707ce8c8b6 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
Content-Type: application/json
} } }
-```
+```
v1.0 Security Ediscoveryholdpolicy Post Sitesources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryholdpolicy-post-sitesources.md
If successful, this method returns a `201 Created` response code and a [siteSour
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_sitesource_from_"
Content-Type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryholdpolicy Post Usersources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryholdpolicy-post-usersources.md
If successful, this method returns a `201 Created` response code and a [userSour
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_usersource_from_"
Content-Type: application/json
"includedSources": "mailbox, site" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryholdpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryholdpolicy-update.md
If successful, this method returns a `204 No Content` response code and an updat
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_ediscoveryholdpolicy"
PATCH https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4
"contentQuery": "bazooka bazooka" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverynoncustodialdatasource Applyhold https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverynoncustodialdatasource-applyhold.md
If successful, this action returns a `202 Accepted` response code.
### Example 1. Apply hold to multiple non-custodial data sources. #### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverynoncustialdatasource.applyhold"
Content-Type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ #### Response
HTTP/1.1 202 Accepted
### Example 2. Apply hold to a single non-custodial data source. #### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverynoncustialdatasource.applyhold"
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/noncustodialdatasources/39333641443238353535383731453339/applyHold ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ #### Response
The following is an example of the response
--> ``` http HTTP/1.1 202 Accepted
-```
+```
v1.0 Security Ediscoverynoncustodialdatasource Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverynoncustodialdatasource-get.md
If successful, this method returns a `200 OK` response code and an [ediscoveryNo
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_ediscoverynoncustodialdatasource"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/noncustodialdatasources/35393639323133394345384344303043?$expand=dataSource ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
Content-Type: application/json
} } }
-```
+```
v1.0 Security Ediscoverynoncustodialdatasource Release https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverynoncustodialdatasource-release.md
If successful, this action returns a `202 Accepted` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverynoncustodialdatasourcethis.release"
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/{ediscoveryCaseId}/noncustodialDataSources/{ediscoveryNoncustodialDataSourceId}/release ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverynoncustodialdatasource Removehold https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverynoncustodialdatasource-removehold.md
If successful, this action returns a `202 Accepted` response code.
### Example 1. Remove hold from multiple non-custodial data sources. #### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverycustodianthis.removehold"
Content-Type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ #### Response
HTTP/1.1 202 Accepted
### Example 2. Remove hold from a single non-custodial data source. #### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverycustodianthis.removehold"
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/noncustodialdatasources/39333641443238353535383731453339/removeHold ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ #### Response
The following is an example of the response
--> ``` http HTTP/1.1 202 Accepted
-```
+```
v1.0 Security Ediscoverynoncustodialdatasource Updateindex https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverynoncustodialdatasource-updateindex.md
If successful, this action returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverynoncustodialdatasourcethis.updateindex"
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/noncustodialdatasources/46333131344239353834433430454335/updateIndex ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryreviewset Export https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewset-export.md
If the export has started successfully, this action returns a `202 Accepted` res
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoveryreviewsetthis.export"
Content-Type: application/json
"exportStructure": "directory" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryreviewset Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewset-get.md
If successful, this method returns a `200 OK` response code and an [ediscoveryRe
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_ediscoveryreviewset"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryreviewset List Files https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewset-list-files.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_ediscoveryfile"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/files?$top=5 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryreviewset List Queries https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewset-list-queries.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_ediscoveryreviewsetquery"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/queries ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryreviewset Post Queries https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewset-post-queries.md
If successful, this method returns a `201 Created` response code and an [ediscov
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_ediscoveryreviewsetquery_from_"
Content-Type: application/json
"contentQuery": "(Author=\"edison\")" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryreviewsetquery Export https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewsetquery-export.md
If successful, this action returns a `202 Accepted` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoveryreviewsetquerythis.export"
Content-Type: application/json
"exportStructure": "directory" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryreviewsetquery Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewsetquery-get.md
If successful, this method returns a `200 OK` response code and an [ediscoveryRe
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_ediscoveryreviewsetquery"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/queries/fcb86cd1-50e0-427c-840e-ba6f087364e5 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryreviewsetquery Run https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewsetquery-run.md
If successful, this function returns a `200 OK` response code and a [microsoft.g
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoveryreviewsetquerythis.run"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/queries/837335b0-1943-444d-a3d1-5522cc21c5a4/run ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryreviewtag Ashierarchy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewtag-ashierarchy.md
If successful, this function returns a `200 OK` response code and a [microsoft.g
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoveryreviewtagthis.ashierarchy"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/tags/asHierarchy ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryreviewtag Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewtag-get.md
If successful, this method returns a `200 OK` response code and an [ediscoveryRe
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_ediscoveryreviewtag"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/tags/062de822f17a4a2e9b833aa3f6c37108 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoveryreviewtag Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewtag-update.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_ediscoveryreviewtag"
PATCH https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-c
"description": "Use Graph API to create tags (updated)" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverysearch Delete Custodiansources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-delete-custodiansources.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_custodiansources_from_ediscoverysearch"
The following is an example of a request.
``` http DELETE https://graph.microsoft.com/beta/security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}/custodianSources/{id}/$ref ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Security Ediscoverysearch Delete Noncustodialsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-delete-noncustodialsources.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_noncustodialsources_from_ediscoverysearch"
The following is an example of a request.
``` http DELETE https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches/c61a5860-d634-4d14-aea7-d82b6f4eb7af/noncustodialSources/35393639323133394345384344303043/$ref ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Security Ediscoverysearch Estimatestatistics https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-estimatestatistics.md
The response will also contain a `Location` header, which contains the location
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverysearchthis.estimatestatistics"
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches/c61a5860-d634-4d14-aea7-d82b6f4eb7af/estimatestatistics ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
The following is an example of the response
--> ``` http HTTP/1.1 204 No Content
-```
+```
v1.0 Security Ediscoverysearch Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-get.md
If successful, this method returns a `200 OK` response code and an [ediscoverySe
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_ediscoverysearch"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/58399dff-cebe-478f-b1af-d3227f1fd645/searches/60150269-9758-4439-9bc4-453c864d082f ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverysearch List Additionalsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-list-additionalsources.md
If successful, this method returns a `200 OK` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_ediscoverynoncustodialdatasource"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches/c61a5860-d634-4d14-aea7-d82b6f4eb7af/additionalSources ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverysearch List Custodiansources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-list-custodiansources.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_datasource"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches/c61a5860-d634-4d14-aea7-d82b6f4eb7af/custodianSources ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverysearch List Lastestimatestatisticsoperation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-list-lastestimatestatisticsoperation.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_ediscoveryestimateoperation"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches/c61a5860-d634-4d14-aea7-d82b6f4eb7af/lastEstimateStatisticsOperation ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverysearch List Noncustodialsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-list-noncustodialsources.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_ediscoverynoncustodialdatasource"
The following is an example of a request.
``` http GET https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches/c61a5860-d634-4d14-aea7-d82b6f4eb7af/noncustodialsources ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Security Ediscoverysearch Post Additionalsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-post-additionalsources.md
If successful, this method returns a `201 Created`.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_datasource_from_"
POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/{ediscovery
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response The following is an example of the response
HTTP/1.1 201 Created
} } }
-```
+```
v1.0 Security Ediscoverysearch Post Custodiansources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-post-custodiansources.md
If successful, this method returns a `204 No Content` response code and a [dataS
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_datasource_from_"
Content-Type: application/json
"@odata.id": "https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/custodians/0053a61a3b6c42738f7606791716a22a/userSources/c25c3914-f9f7-43ee-9cba-a25377e0cec6" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
The following is an example of the response
--> ``` http HTTP/1.1 204 No Content
-```
+```
v1.0 Security Ediscoverysearch Post Noncustodialsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-post-noncustodialsources.md
If successful, this method returns a `204 No Content` response code and an [edis
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_ediscoverynoncustodialdatasource_from_"
Content-Type: application/json
"@odata.id": "https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/noncustodialDataSources/39333641443238353535383731453339" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
The following is an example of the response
--> ``` http HTTP/1.1 204 No Content
-```
+```
v1.0 Security Ediscoverysearch Purgedata https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-purgedata.md
To check the status of the purge data operation, make a GET request to the locat
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "ediscoverysearchthis.purgedata"
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/security/cases/eDiscoverycases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches/c61a5860-d634-4d14-aea7-d82b6f4eb7af/purgeData ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
The following is an example of the response
--> ``` http HTTP/1.1 202 Accepted
-```
+```
v1.0 Security Ediscoverysearch Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-update.md
If successful, this method returns a `204 No Content` response code and an updat
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_ediscoverysearch"
Content-Type: application/json
"displayName": "Teams search" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
The following is an example of the response
--> ``` http HTTP/1.1 204 No Content
-```
+```
v1.0 Subscription Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subscription-delete.md
Depending on the resource and the permission type (delegated or application) req
|[group](../resources/group.md) | Group.Read.All | Not supported. | Group.Read.All | |[group conversation](../resources/conversation.md) | Group.Read.All | Not supported. | Not supported. | |[list](../resources/list.md) | Sites.ReadWrite.All | Not supported. | Sites.ReadWrite.All |
-|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read |
+|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.Read |
|[online meeting](../resources/onlinemeeting.md) | Not supported | Not supported | OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All | |[presence](../resources/presence.md) | Presence.Read.All | Not supported. | Not supported. | |[printer](../resources/printer.md) | Not supported. | Not supported. | Printer.Read.All, Printer.ReadWrite.All |
v1.0 Subscription Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subscription-get.md
Depending on the resource and the permission type (delegated or application) req
|[group](../resources/group.md) | Group.Read.All | Not supported | Group.Read.All | |[group conversation](../resources/conversation.md) | Group.Read.All | Not supported | Not supported | |[list](../resources/list.md) | Sites.ReadWrite.All | Not supported | Sites.ReadWrite.All |
-|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read |
+|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.Read |
|[online meeting](../resources/onlinemeeting.md) | Not supported | Not supported | OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All | |[presence](../resources/presence.md) | Presence.Read.All | Not supported | Not supported | |[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All |
v1.0 Subscription List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subscription-list.md
This API supports the following permission scopes; to learn more, including how
|[group](../resources/group.md) | Group.Read.All, Subscription.Read.All | Not supported | Group.Read.All | |[group conversation](../resources/conversation.md) | Group.Read.All, Subscription.Read.All | Not supported | Not supported | |[list](../resources/list.md) | Sites.ReadWrite.All, Subscription.Read.All | Not supported | Sites.ReadWrite.All |
-|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read, Subscription.Read.All | Mail.ReadBasic, Mail.Read, Subscription.Read.All | Mail.ReadBasic, Mail.Read |
+|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read, Subscription.Read.All | Mail.ReadBasic, Mail.Read, Subscription.Read.All | Mail.Read |
|[online meeting](../resources/onlinemeeting.md) | Not supported | Not supported | OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All | |[presence](../resources/presence.md) | Presence.Read.All, Subscription.Read.All | Not supported | Not supported | |[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All |
v1.0 Subscription Post Subscriptions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subscription-post-subscriptions.md
Depending on the resource and the permission type (delegated or application) req
|[group](../resources/group.md) | Group.Read.All | Not supported | Group.Read.All | |[group conversation](../resources/conversation.md) | Group.Read.All | Not supported | Not supported | |[list](../resources/list.md) | Sites.ReadWrite.All | Not supported | Sites.ReadWrite.All |
-|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read |
+|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.Read |
|[online meeting](../resources/onlinemeeting.md) | Not supported | Not supported | OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All | |[presence](../resources/presence.md) | Presence.Read.All | Not supported | Not supported | |[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All |
v1.0 Subscription Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subscription-update.md
Depending on the resource and the permission type (delegated or application) req
|[group](../resources/group.md) | Group.Read.All | Not supported | Group.Read.All | |[group conversation](../resources/conversation.md) | Group.Read.All | Not supported | Not supported | |[list](../resources/list.md) | Sites.ReadWrite.All | Not supported | Sites.ReadWrite.All |
-|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read |
+|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.Read |
|[online meeting](../resources/onlinemeeting.md) | Not supported | Not supported | OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All | |[presence](../resources/presence.md) | Presence.Read.All | Not supported | Not supported | |[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All |
v1.0 Temporaryaccesspassauthenticationmethod Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/temporaryaccesspassauthenticationmethod-delete.md
Title: "Delete temporaryAccessPassAuthenticationMethod"
-description: "Deletes a temporaryAccessPassAuthenticationMethod object."
+description: "Delete a user's temporaryAccessPassAuthenticationMethod object."
ms.localizationpriority: medium ms.prod: "identity-and-sign-in"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Delete a [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object.
-
-While the current Temporary Access Pass on the user is valid, it needs to be deleted before a new Temporary Access Pass can be created on the user.
+Delete a users's [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.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).
If successful, this method returns a `204 No Content` response code. It does not
## Examples ### Request-
-# [HTTP](#tab/http)
<!-- { "blockType": "request",
- "name": "delete_temporaryaccesspassauthenticationmethod"
+ "name": "delete_temporaryAccessPassAuthenticationMethod"
} -->
-``` http
-DELETE https://graph.microsoft.com/beta/users/kim@contoso.com/authentication/temporaryAccessPassMethods/{id}
+```msgraph-interactive
+DELETE https://graph.microsoft.com/beta/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods/05267842-25b2-4b21-8abd-8e4982796f7f
```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PowerShell](#tab/powershell)
---- ### Response
-**Note:** The response object shown here might be shortened for readability.
+ <!-- { "blockType": "response", "truncated": true } -->+ ``` http HTTP/1.1 204 No Content ```
v1.0 Temporaryaccesspassauthenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/temporaryaccesspassauthenticationmethod-get.md
Title: "Get temporaryAccessPassAuthenticationMethod"
-description: "Read the properties and relationships of a temporaryAccessPassAuthenticationMethod object."
+description: "Retrieve a user's temporaryAccessPassAuthenticationMethod object."
ms.localizationpriority: medium ms.prod: "identity-and-sign-in"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a user's single [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object.
+Retrieve a user's single [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.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).
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) objects in the response body. This API will only return a single object in the collection as a user can have only one Temporary Access Pass method.
## Examples ### Request-
-# [HTTP](#tab/http)
<!-- { "blockType": "request",
- "name": "get_temporaryaccesspassauthenticationmethod"
+ "name": "get_temporaryAccessPassAuthenticationMethod"
} -->
-``` http
-GET https://graph.microsoft.com/beta/users/kim@contoso.com/authentication/temporaryAccessPassMethods/30fd0dfc-0dfc-30fd-fc0d-fd30fc0dfd30
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods/05267842-25b2-4b21-8abd-8e4982796f7f
```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PowerShell](#tab/powershell)
---- ### Response
-**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
HTTP/1.1 200 OK
Content-Type: application/json {
- "value": {
- "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
- "id": "30fd0dfc-0dfc-30fd-fc0d-fd30fc0dfd30",
+ "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
+ "id": "6f1967b7-15e8-4935-ac26-d50770ed07a7",
"temporaryAccessPass": null,
- "createdDateTime": "String (timestamp)",
- "startDateTime": "String (timestamp)",
- "lifetimeInMinutes": "Integer",
- "isUsableOnce": "Boolean",
- "isUsable": "Boolean",
- "methodUsabilityReason": "String"
- }
+ "createdDateTime": "2022-06-02T16:21:09.5893903Z",
+ "startDateTime": "2022-06-05T00:00:00Z",
+ "lifetimeInMinutes": 60,
+ "isUsableOnce": false,
+ "isUsable": false,
+ "methodUsabilityReason": "NotYetValid"
} ```
v1.0 Temporaryaccesspassauthenticationmethod Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/temporaryaccesspassauthenticationmethod-post.md
- Title: "Create temporaryAccessPassAuthenticationMethod"
-description: "Create a new temporaryAccessPassAuthenticationMethod object."
-
-doc_type: apiPageType
--
-# Create temporaryAccessPassAuthenticationMethod
-Namespace: microsoft.graph
--
-Create a new [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object on a user. A user can only have one Temporary Access Pass. The passcode can be used between the start and end time of the Temporary Access Pass. If the user requires a new Temporary Access Pass:
-* While the current Temporary Access Pass is valid ΓÇô the admin needs to delete the existing Temporary Access Pass and create a new pass on the user. Deleting a valid Temporary Access Pass will revoke the userΓÇÖs sessions.
-* After the Temporary Access Pass has expired ΓÇô a new temporary access pass overrides the current temporary access pass and doesn't revoke the userΓÇÖs sessions.
--
-## 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) | UserAuthenticationMethod.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | UserAuthenticationMethod.ReadWrite.All |
-
-For delegated scenarios where an admin is acting on another user, the admin needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
-* Global administrator
-* Privileged authentication administrator
-* Authentication administrator
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-POST /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods
-```
-
-## 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 [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object.
-
-The following table describes optional properties that can be used when creating the [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md).
-
-|Property|Type|Description|Required|
-|:|:|:|:|
-|startDateTime|DateTimeOffset|The date and time when the temporaryAccessPass becomes available to use, if not set the Temporary Access Pass is available to use at creation time.| No|
-|lifetimeInMinutes|Int32|The lifetime of the temporaryAccessPass in minutes starting at creation time or at startDateTime, if set. Minimum 10, Maximum 43200 (equivalent to 30 days).| No|
-|isUsableOnce|Boolean|Determines if the pass is limited to a one time use. If True ΓÇô the pass can be used once, if False ΓÇô the pass can be used multiple times within the temporaryAccessPass life time. A multi-use Temporary Access Pass (isUsableOnce = false), can only be created and used for sign-in if it is allowed by the Temporary Access Pass Authentication method policy.| No|
---
-## Response
-
-If successful, this method returns a `201 Created` response code and a [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object in the response body.
-
-## Examples
-
-### Request
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "create_temporaryaccesspassauthenticationmethod_from_"
-}
>
-``` http
-POST https://graph.microsoft.com/beta/users/kim@contoso.com/authentication/temporaryAccessPassMethods
-Content-Type: application/json
-
-{
- "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
- "startDateTime": "2021-01-26T00:00:00.000Z",
- "lifetimeInMinutes": 60,
- "isUsableOnce": false
-}
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PowerShell](#tab/powershell)
----
-### Response
-**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.temporaryAccessPassAuthenticationMethod"
-}
>
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-
-{
- "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
- "id": "81757535-e21e-4330-a338-33b8038ff12b",
- "temporaryAccessPass": "nc+&G=xwDKCz",
- "createdDateTime": "2021-01-25T23:53:35.5026721Z",
- "startDateTime": "2021-01-26T00:00:00Z",
- "lifetimeInMinutes": 60,
- "isUsableOnce": false,
- "isUsable": false,
- "methodUsabilityReason": "NotYetValid"
-
-}
-```
v1.0 Temporaryaccesspassauthenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/temporaryaccesspassauthenticationmethodconfiguration-delete.md
Title: "Delete temporaryAccessPassAuthenticationMethodConfiguration"
-description: "Remove changes made to a temporaryAccessPassAuthenticationMethodConfiguration object."
+description: "Revert the Temporary Access Pass policy to its default configuration, represented by a default temporaryAccessPassAuthenticationMethodConfiguration object."
ms.localizationpriority: medium ms.prod: "identity-and-sign-in"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Remove changes made to the [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md) object by reverting the policy to its default configuration.
+Revert the Temporary Access Pass policy to its default configuration, represented by a default [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.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).
For delegated scenarios, the administrator needs one of the following [Azure AD
} --> ``` http
-DELETE /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/TemporaryAccessPass
+DELETE /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass
``` - ## Request headers |Name|Description| |:|:|
If successful, this method returns a `204 No Content` response code.
"name": "delete_temporaryaccesspassauthenticationmethodconfiguration" } -->
+```msgraph-interactive
+DELETE https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass`
+```
### Response- <!-- { "blockType": "response", "truncated": true } -->+ ``` http HTTP/1.1 204 No Content
-```
+```
v1.0 Temporaryaccesspassauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/temporaryaccesspassauthenticationmethodconfiguration-get.md
Title: "Get temporaryAccessPassAuthenticationMethodConfiguration"
-description: "Read the properties and relationships of a temporaryAccessPassAuthenticationMethodConfiguration object."
-
+description: "Read the details of the Temporary Access Pass policy for the Azure AD tenant, represented by a temporaryAccessPassAuthenticationMethodConfiguration object."
+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: apiPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Read the properties and relationships of a [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md) object, which represents the Temporary Access Pass [authentication method policy](../resources/authenticationmethodspolicies-overview.md) for the Azure Active Directory (Azure AD) tenant.
+Read the details of the Temporary Access Pass policy for the Azure Active Directory (Azure AD) tenant, represented by a [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.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).
For delegated scenarios, the administrator needs one of the following [Azure AD
} --> ``` http
-GET /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/TemporaryAccessPass
+GET /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass
``` ## Request headers |Name|Description|
Do not supply a request body for this method.
## Response If successful, this method returns a `200 OK` response code and a [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md) object in the response body. - ## Examples ### Request+ The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_temporaryaccesspassauthenticationmethodconfiguration" } -->
-``` http
+```msgraph-interactive
GET https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.+ <!-- { "blockType": "response", "truncated": true, "@odata.type": "microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration" } -->
-``` http
+```http
HTTP/1.1 200 OK Content-Type: application/json
Content-Type: application/json
"defaultLength": 8, "minimumLifetimeInMinutes": 60, "maximumLifetimeInMinutes": 480,
- "isUsableOnce": true,
+ "isUsableOnce": false,
"includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('TemporaryAccessPass')/microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration/includeTargets", "includeTargets": [ {
Content-Type: application/json
} ] }
-```
+```
v1.0 Temporaryaccesspassauthenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/temporaryaccesspassauthenticationmethodconfiguration-update.md
Title: "Update temporaryAccessPassAuthenticationMethodConfiguration"
-description: "Update the properties of a temporaryAccessPassAuthenticationMethodConfiguration object."
+description: "Update the Temporary Access Pass policy for the Azure AD tenant, represented by a temporaryAccessPassAuthenticationMethodConfiguration object."
ms.localizationpriority: medium ms.prod: "identity-and-sign-in"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Update the properties of a [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md) object, which represents the Temporary Access Pass authentication method policy for the Azure AD tenant.
+Update the Temporary Access Pass policy for the Azure AD tenant, represented by a [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.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).
For delegated scenarios, the administrator needs one of the following [Azure AD
* Authentication Policy Administrator * Global Administrator - ## HTTP request <!-- {
PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/T
## Request body In the request body, supply a JSON representation of the [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md) object with the values of 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.
-All properties of the object can be updated. For a list of properties, see [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md).
+All properties and relationships of the object can be updated. For the list of properties and relationships, see [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md).
->**Note:** The `@odata.type` property with a value of `#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration` must be included in the body.
+> [!NOTE]
+> The **@odata.type** property with a value of `#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration` must be included in the request body.
## Response
If successful, this method returns a `204 No Content` response code. It does not
## Examples ### Request-
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_temporaryaccesspassauthenticationmethodconfiguration" } -->
-``` http
-PATCH https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/TemporaryAccessPass
+```http
+PATCH https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass
Content-Type: application/json { "@odata.type":"#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration",
- "state":"enabled",
- "defaultLifetimeInMinutes":60,
- "defaultLength":8,
- "minimumLifetimeInMinutes":60,
- "maximumLifetimeInMinutes":1440,"
- isUsableOnce":false,
- "includeTargets": [
- {
- "targetType": "group",
- "id": "all_users",
- "isRegistrationRequired": false,
- "useForSignIn": true
- }
- ]
+ "isUsableOnce": true
}-- ```
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-
-# [Go](#tab/go)
--- ### Response <!-- {
Content-Type: application/json
"truncated": true } -->
-``` http
+
+```http
HTTP/1.1 204 No Content
-```
+```
v1.0 Temporaryaccesspassauthenticationmethod https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/temporaryaccesspassauthenticationmethod.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a Temporary Access Pass registered to a user. A Temporary Access Pass is a time-limited passcode that serves as a strong credential and allows onboarding of passwordless credentials.
+Represents a Temporary Access Pass registered to a user. A Temporary Access Pass is a time-limited passcode that serves as a strong credential and allows onboarding of passwordless credentials. The availability and settings that can be configured for the **temporaryAccessPassAuthenticationMethod** depends on the [Temporary Access Pass methods policy](temporaryaccesspassauthenticationmethodconfiguration.md).
## Methods |Method|Return type|Description| |:|:|:|
-|[List](../api/temporaryaccesspassauthenticationmethod-list.md)|[temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) collection|Retrieve a list of a user's **temporaryAccessPassAuthenticationMethod** objects and their properties. Users can only have one Temporary Access Pass authentication method.|
-|[Create](../api/temporaryaccesspassauthenticationmethod-post.md)|[temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md)|Create a user's **temporaryAccessPassAuthenticationMethod** object.|
+|[List](../api/authentication-list-temporaryaccesspassmethods.md)|[temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) collection|Retrieve a list of a user's **temporaryAccessPassAuthenticationMethod** objects and their properties. Users can only have one Temporary Access Pass authentication method.|
+|[Create](../api/authentication-post-temporaryaccesspassmethods.md)|[temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md)|Create a user's **temporaryAccessPassAuthenticationMethod** object.|
|[Get](../api/temporaryaccesspassauthenticationmethod-get.md)|[temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md)|Retrieve the properties of the user's **temporaryAccessPassAuthenticationMethod** object.| |[Delete](../api/temporaryaccesspassauthenticationmethod-delete.md)|None|Delete a user's **temporaryAccessPassAuthenticationMethod** object.| ## Properties |Property|Type|Description| |:|:|:|
-|id|String|The identifier of the Temporary Access Pass registered to this user.|
-|temporaryAccessPass|String|The temporaryAccessPass used to authenticate. Returned only on creation of a new temporaryAccessPass; returned as NULL with GET.|
-|createdDateTime|DateTimeOffset|The date and time when the temporaryAccessPass was created.|
-|startDateTime|DateTimeOffset|The date and time when the temporaryAccessPass becomes available to use.|
-|lifetimeInMinutes|Int32|The lifetime of the temporaryAccessPass in minutes starting at startDateTime. Minimum 10, Maximum 43200 (equivalent to 30 days).|
-|isUsableOnce|Boolean|Determines whether the pass is limited to a one time use. If `true`, the pass can be used once; if `false`, the pass can be used multiple times within the temporaryAccessPass lifetime.|
+|createdDateTime|DateTimeOffset|The date and time when the Temporary Access Pass was created.|
+|id|String|The identifier of the Temporary Access Pass registered to this user. Inherited from [entity](../resources/entity.md).|
+|isUsableOnce|Boolean|Determines whether the pass is limited to a one-time use. If `true`, the pass can be used once; if `false`, the pass can be used multiple times within the Temporary Access Pass lifetime.|
|isUsable|Boolean|The state of the authentication method that indicates whether it's currently usable by the user.|
-|methodUsabilityReason|String|Details about usability state (isUsable). Reasons can include: `enabledByPolicy`, `disabledByPolicy`, `expired`, `notYetValid`, `oneTimeUsed`.|
+|lifetimeInMinutes|Int32|The lifetime of the Temporary Access Pass in minutes starting at **startDateTime**. Must be between 10 and 43200 inclusive (equivalent to 30 days).|
+|methodUsabilityReason|String|Details about the usability state (**isUsable**). Reasons can include: `EnabledByPolicy`, `DisabledByPolicy`, `Expired`, `NotYetValid`, `OneTimeUsed`.|
+|startDateTime|DateTimeOffset|The date and time when the Temporary Access Pass becomes available to use and when **isUsable** is `true` is enforced.|
+|temporaryAccessPass|String|The Temporary Access Pass used to authenticate. Returned only on creation of a new **temporaryAccessPassAuthenticationMethod** object; Hidden in subsequent read operations and returned as `null` with GET.|
## Relationships
v1.0 Temporaryaccesspassauthenticationmethodconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/temporaryaccesspassauthenticationmethodconfiguration.md
Title: "temporaryAccessPassAuthenticationMethodConfiguration resource type"
-description: "Represents a Temporary Access Pass authentication methods policy."
+description: "Represents a Temporary Access Pass authentication methods policy that defines the configuration settings and users or groups who are enabled to use the authentication method."
ms.localizationpriority: medium ms.prod: "identity-and-access-reports"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a Temporary Access Pass authentication methods policy. The Authentication methods policy defines the configuration settings and users or groups who are enabled to use the authentication method.
+Represents a Temporary Access Pass authentication methods policy that defines the configuration settings and users or groups who are enabled to use the [Temporary Access Pass authentication method](temporaryaccesspassauthenticationmethod.md).
## Methods |Method|Return type|Description| |:|:|:|
-|[Get](../api/temporaryaccesspassauthenticationmethodconfiguration-get.md)|[temporaryaccesspassauthenticationmethodconfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md)|Read the properties and relationships of a **temporaryaccesspassauthenticationmethodconfiguration** object.|
-|[Update](../api/temporaryaccesspassauthenticationmethodconfiguration-update.md)|[temporaryaccesspassauthenticationmethodconfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md)|Update the properties of a **temporaryaccesspassauthenticationmethodconfiguration** object.|
-|[Delete](../api/temporaryaccesspassauthenticationmethodconfiguration-delete.md)|None|Reverts the **temporaryaccesspassauthenticationmethodconfiguration** object to its default configuration.|
+|[Get](../api/temporaryaccesspassauthenticationmethodconfiguration-get.md)|[temporaryaccesspassauthenticationmethodconfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md)|Read the properties and relationships of a **temporaryAccessPassAuthenticationMethodConfiguration** object.|
+|[Update](../api/temporaryaccesspassauthenticationmethodconfiguration-update.md)|None|Update the properties of a **temporaryAccessPassAuthenticationMethodConfiguration** object.|
+|[Delete](../api/temporaryaccesspassauthenticationmethodconfiguration-delete.md)|None|Reverts the **temporaryAccessPassAuthenticationMethodConfiguration** object to its default configuration.|
## Properties |Property|Type|Description| |:|:|:|
-|id|String|The authentication method policy identifier.|
-|minimumLifetimeInMinutes|Int|Minimum lifetime in minutes for any temporaryAccessPass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).|
-|maximumLifetimeInMinutes|Int|Maximum lifetime in minutes for any temporaryAccessPass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).|
-|defaultLifetimeInMinutes|int|Default lifetime, in minutes, for a temporaryAccessPass. Value can be between the minimumLifetimeInMinutes and maximumLifetimeInMinutes.|
-|defaultLength|int|Default length, in characters, of a temporaryAccessPass, between 8 and 48 characters.|
-|isUsableOnce|Boolean |If `true`, all the passes in the tenant will be restricted to one-time use. If `false`, passes in the tenant can be created to be either one-time use or multiple time use.|
-|state|authenticationMethodState|Possible values are: `enabled`, `disabled`.|
+|defaultLength|Int|Default length in characters of a Temporary Access Pass object. Must be between 8 and 48 characters.|
+|defaultLifetimeInMinutes|Int|Default lifetime in minutes for a Temporary Access Pass. Value can be any integer between the **minimumLifetimeInMinutes** and **maximumLifetimeInMinutes**.|
+|id|String|The identifier of the authentication method policy. Inherited from [entity](entity.md).|
+|isUsableOnce|Boolean |If `true`, all the passes in the tenant will be restricted to one-time use. If `false`, passes in the tenant can be created to be either one-time use or reusable.|
+|minimumLifetimeInMinutes|Int|Minimum lifetime in minutes for any Temporary Access Pass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).|
+|maximumLifetimeInMinutes|Int|Maximum lifetime in minutes for any Temporary Access Pass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).|
+|state|authenticationMethodState|Whether the Temporary Access Pass method is enabled in the tenant. Possible values are: `enabled`, `disabled`. Inherited from [authenticationMethodConfiguration](authenticationmethodconfiguration.md). |
## Relationships |Relationship|Type|Description|
The following is a JSON representation of the resource.
"defaultLength": "Integer", "minimumLifetimeInMinutes": "Integer", "maximumLifetimeInMinutes": "Integer",
- "isUsableOnce": "Boolean"
+ "isUsableOnce": "Boolean",
+ "includeTargets": [ { "@odata.type": "microsoft.graph.authenticationMethodTarget" } ]
} ```
v1.0 Authentication List Temporaryaccesspassmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/authentication-list-temporaryaccesspassmethods.md
Title: "List temporaryAccessPassAuthenticationMethods"
+ Title: "List temporaryAccessPassMethods"
description: "Get a list of the temporaryAccessPassAuthenticationMethod objects for a user." ms.localizationpriority: medium
ms.prod: "identity-and-sign-in"
doc_type: apiPageType
-# List temporaryAccessPassAuthenticationMethods
+# List temporaryAccessPassMethods
Namespace: microsoft.graph Retrieve a list of a user's [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) objects and their properties. This API will only return a single object in the collection as a user can have only one Temporary Access Pass method.
If successful, this method returns a `200 OK` response code and a collection of
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_temporaryaccesspassauthenticationmethod"
If successful, this method returns a `200 OK` response code and a collection of
```msgraph-interactive GET https://graph.microsoft.com/v1.0/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Authentication Post Temporaryaccesspassmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/authentication-post-temporaryaccesspassmethods.md
Title: "Create temporaryAccessPassAuthenticationMethod"
+ Title: "Create temporaryAccessPassMethod"
description: "Create a new temporaryAccessPassAuthenticationMethod object for a user." ms.localizationpriority: medium
ms.prod: "identity-and-sign-in"
doc_type: apiPageType
-# Create temporaryAccessPassAuthenticationMethod
+# Create temporaryAccessPassMethod
Namespace: microsoft.graph Create a new [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object on a user. A user can only have one Temporary Access Pass that's usable within its specified lifetime. If the user requires a new Temporary Access Pass while the current Temporary Access Pass is valid, the admin can create a new Temporary Access Pass for the user, the previous Temporary Access Pass will be deleted, and a new Temporary Access Pass will be created.
If successful, this method returns a `201 Created` response code and a [temporar
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_temporaryaccesspassauthenticationmethod_from_"
Content-Type: application/json
"isUsableOnce": false } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Connectedorganization Delete Internalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/connectedorganization-delete-internalsponsors.md
DELETE https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+
v1.0 Directory Deleteditems Restore https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/directory-deleteditems-restore.md
POST https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}/restore
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+ ### Response
v1.0 Driveitem Checkin https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/driveitem-checkin.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+
v1.0 Driveitem Checkout https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/driveitem-checkout.md
POST /drives/{drive-id}/items/{item-id}/checkout
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+
v1.0 Driveitemversion Get Contents https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/driveitemversion-get-contents.md
Title: "Download contents of a DriveItemVersion resource"
-description: "Retrieve the contents of a specific version of a DriveItem."
+ Title: "Download contents of a driveItemVersion resource"
+description: "Retrieve the contents of a specific version of a driveItem."
ms.localizationpriority: medium ms.prod: "sharepoint" doc_type: apiPageType
-# Download contents of a DriveItemVersion resource
+# Download contents of a driveItemVersion resource
Namespace: microsoft.graph
-Retrieve the contents of a specific version of a [DriveItem](../resources/driveitem.md).
+Retrieve the contents of a specific version of a [driveItem](../resources/driveitem.md).
## Permissions
GET /users/{user-id}/drive/items/{item-id}/versions/{version-id}/content
Returns a `302 Found` response redirecting to a pre-authenticated download URL for the bytes of the file. To download the contents of the file your application will need to follow the `Location` header in the response.
-Many HTTP client libraries will automatically follow the 302 redirection and start downloading the file immedately.
+Many HTTP client libraries will automatically follow the 302 redirection and start downloading the file immediately.
Pre-authenticated download URLs are only valid for a short period of time (a few minutes) and do not require an `Authorization` header to download.
Location: https://onedrive.com/34FF49D6...
OneDrive does not preserve the complete metadata for previous versions of a file.
-When your app retrieves the list of available versions for a file, a [DriveItemVersion](../resources/driveitemversion.md) resource is returned that provides the available information about the specific version.
+When your app retrieves the list of available versions for a file, a [driveItemVersion](../resources/driveitemversion.md) resource is returned that provides the available information about the specific version.
<!-- { "type": "#page.annotation",
v1.0 Entitlementmanagement Post Assignmentpolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/entitlementmanagement-post-assignmentpolicies.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-accesspackageassignmentpolicy-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+
v1.0 Invitation Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/invitation-post.md
If successful, this method returns `201 Created` response code and [invitation](
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_invitation_post"
Content-type: application/json
"inviteRedirectUrl": "https://myapp.contoso.com" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+++ ### Response
v1.0 Subscription Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/subscription-delete.md
Depending on the resource and the permission type (delegated or application) req
|[group](../resources/group.md) | Group.Read.All | Not supported. | Group.Read.All | |[group conversation](../resources/conversation.md) | Group.Read.All | Not supported. | Not supported. | |[list](../resources/list.md) | Sites.ReadWrite.All | Not supported. | Sites.ReadWrite.All |
-|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read |
+|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.Read |
|[printer](../resources/printer.md) | Not supported. | Not supported. | Printer.Read.All, Printer.ReadWrite.All | |[printTaskDefinition](../resources/printtaskdefinition.md) | Not supported. | Not supported. | PrintTaskDefinition.ReadWrite.All | |[security alert](../resources/alert.md) | SecurityEvents.ReadWrite.All | Not supported. | SecurityEvents.ReadWrite.All |
v1.0 Subscription Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/subscription-get.md
Depending on the resource and the permission type (delegated or application) req
|[group](../resources/group.md) | Group.Read.All | Not supported | Group.Read.All | |[group conversation](../resources/conversation.md) | Group.Read.All | Not supported | Not supported | |[list](../resources/list.md) | Sites.ReadWrite.All | Not supported | Sites.ReadWrite.All |
-|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read |
+|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.Read |
|[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All | |[printTaskDefinition](../resources/printtaskdefinition.md) | Not supported | Not supported | PrintTaskDefinition.ReadWrite.All | |[security alert](../resources/alert.md) | SecurityEvents.ReadWrite.All | Not supported | SecurityEvents.ReadWrite.All |
v1.0 Subscription List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/subscription-list.md
This API supports the following permission scopes; to learn more, including how
|[group](../resources/group.md) | Group.Read.All, Subscription.Read.All | Not supported | Group.Read.All | |[group conversation](../resources/conversation.md) | Group.Read.All, Subscription.Read.All | Not supported | Not supported | |[list](../resources/list.md) | Sites.ReadWrite.All, Subscription.Read.All | Not supported | Sites.ReadWrite.All |
-|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read, Subscription.Read.All | Mail.ReadBasic, Mail.Read, Subscription.Read.All | Mail.ReadBasic, Mail.Read |
+|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read, Subscription.Read.All | Mail.ReadBasic, Mail.Read, Subscription.Read.All | Mail.Read |
|[presence](../resources/presence.md) | Presence.Read.All, Subscription.Read.All | Not supported | Not supported | |[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All | |[printTaskDefinition](../resources/printtaskdefinition.md) | Not supported | Not supported | PrintTaskDefinition.ReadWrite.All |
v1.0 Subscription Post Subscriptions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/subscription-post-subscriptions.md
Depending on the resource and the permission type (delegated or application) req
|[group](../resources/group.md) | Group.Read.All | Not supported | Group.Read.All | |[group conversation](../resources/conversation.md) | Group.Read.All | Not supported | Not supported | |[list](../resources/list.md) | Sites.ReadWrite.All | Not supported | Sites.ReadWrite.All |
-|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read |
+|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.Read |
|[presence](../resources/presence.md) | Presence.Read.All | Not supported | Not supported | |[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All | |[printTaskDefinition](../resources/printtaskdefinition.md) | Not supported | Not supported | PrintTaskDefinition.ReadWrite.All |
v1.0 Subscription Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/subscription-update.md
Depending on the resource and the permission type (delegated or application) req
|[group](../resources/group.md) | Group.Read.All | Not supported | Group.Read.All | |[group conversation](../resources/conversation.md) | Group.Read.All | Not supported | Not supported | |[list](../resources/list.md) | Sites.ReadWrite.All | Not supported | Sites.ReadWrite.All |
-|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read |
+|[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.Read |
|[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All | |[printTaskDefinition](../resources/printtaskdefinition.md) | Not supported | Not supported | PrintTaskDefinition.ReadWrite.All | |[security alert](../resources/alert.md) | SecurityEvents.ReadWrite.All | Not supported | SecurityEvents.ReadWrite.All |
v1.0 Temporaryaccesspassauthenticationmethod Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/temporaryaccesspassauthenticationmethod-delete.md
Title: "Delete temporaryAccessPassAuthenticationMethod"
-description: "Deletes a user's temporaryAccessPassAuthenticationMethod object."
+description: "Delete a user's temporaryAccessPassAuthenticationMethod object."
ms.localizationpriority: medium ms.prod: "identity-and-sign-in"
If successful, this method returns a `204 No Content` response code. It does not
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_temporaryAccessPassAuthenticationMethod"
If successful, this method returns a `204 No Content` response code. It does not
```msgraph-interactive DELETE https://graph.microsoft.com/v1.0/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods/05267842-25b2-4b21-8abd-8e4982796f7f ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
v1.0 Temporaryaccesspassauthenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/temporaryaccesspassauthenticationmethod-get.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_temporaryAccessPassAuthenticationMethod"
If successful, this method returns a `200 OK` response code and a collection of
```msgraph-interactive GET https://graph.microsoft.com/v1.0/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods/05267842-25b2-4b21-8abd-8e4982796f7f ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Temporaryaccesspassauthenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/temporaryaccesspassauthenticationmethodconfiguration-delete.md
If successful, this method returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_temporaryaccesspassauthenticationmethodconfiguration"
If successful, this method returns a `204 No Content` response code.
```msgraph-interactive DELETE https://graph.microsoft.com/v1.0/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass` ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response <!-- {
DELETE https://graph.microsoft.com/v1.0/policies/authenticationMethodsPolicy/aut
``` http HTTP/1.1 204 No Content
-```
+```
v1.0 Temporaryaccesspassauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/temporaryaccesspassauthenticationmethodconfiguration-get.md
If successful, this method returns a `200 OK` response code and a [temporaryAcce
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_temporaryaccesspassauthenticationmethodconfiguration"
If successful, this method returns a `200 OK` response code and a [temporaryAcce
```msgraph-interactive GET https://graph.microsoft.com/v1.0/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response
HTTP/1.1 200 OK
Content-Type: application/json {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#authenticationMethodConfigurations/$entity",
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#authenticationMethodConfigurations/$entity",
"@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration", "id": "TemporaryAccessPass", "state": "enabled",
Content-Type: application/json
} ] }
-```
+```
v1.0 Temporaryaccesspassauthenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/temporaryaccesspassauthenticationmethodconfiguration-update.md
PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/T
## Request body In the request body, supply a JSON representation of the [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md) object with the values of 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.
-All properties of the object can be updated. For a list of properties, see [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md).
+All properties and relationships of the object can be updated. For the list of properties and relationships, see [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md).
> [!NOTE] > The **@odata.type** property with a value of `#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration` must be included in the request body.
If successful, this method returns a `204 No Content` response code. It does not
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_temporaryaccesspassauthenticationmethodconfiguration"
PATCH https://graph.microsoft.com/v1.0/policies/authenticationMethodsPolicy/auth
Content-Type: application/json {
+ "@odata.type":"#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration",
"isUsableOnce": true } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+++ ### Response <!-- {
Content-Type: application/json
```http HTTP/1.1 204 No Content
-```
+```
v1.0 Groups Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/groups-overview.md
Title: "Working with groups in Microsoft Graph"
-description: "Groups are collections of principals with shared access to resources in Microsoft services or in your app. Different principals such as users, other groups, devices, and applications can be part of groups. Using groups helps you avoid working with individual principals and simplifies management of access to your resources."
+description: "Use the groups API to create and manage different types of groups such as Microsoft 365 groups, security groups, mail-enabled security groups, and distribution groups."
ms.localizationpriority: high ms.prod: "groups"
doc_type: conceptualPageType
Groups are collections of principals with shared access to resources in Microsoft services or in your app. Different principals such as users, other groups, devices, and applications can be part of groups. Using groups helps you avoid working with individual principals and simplifies management of access to your resources.
-Microsoft Graph exposes the groups API to create and manage different types of groups and group functionality.
+Microsoft Graph exposes the groups API to create and manage different types of groups and group functionality.
> [!NOTE] > 1. Groups can only be created through work or school accounts. Personal Microsoft accounts don't support groups.
Azure Active Directory (Azure AD) supports the following types of groups.
- Distribution groups > [!NOTE]
-> Microsoft also supports [dynamic distribution groups](/exchange/recipients/dynamic-distribution-groups/dynamic-distribution-groups?view=exchserver-2019) which cannot be managed or retrieved through Microsoft Graph.
+> Microsoft also supports [dynamic distribution groups](/exchange/recipients/dynamic-distribution-groups/dynamic-distribution-groups?view=exchserver-2019&preserve-view=true) which cannot be managed or retrieved through Microsoft Graph.
Only Microsoft 365 and security groups can be managed through the Microsoft Graph groups API. Mail-enabled and distribution groups are read-only through Microsoft Graph.
v1.0 Temporaryaccesspassauthenticationmethod https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/temporaryaccesspassauthenticationmethod.md
doc_type: resourcePageType
Namespace: microsoft.graph
-Represents a Temporary Access Pass registered to a user. A Temporary Access Pass is a time-limited passcode that serves as a strong credential and allows onboarding of passwordless credentials.
+Represents a Temporary Access Pass registered to a user. A Temporary Access Pass is a time-limited passcode that serves as a strong credential and allows onboarding of passwordless credentials. The availability and settings that can be configured for the **temporaryAccessPassAuthenticationMethod** depends on the [Temporary Access Pass methods policy](temporaryaccesspassauthenticationmethodconfiguration.md).
## Methods
Represents a Temporary Access Pass registered to a user. A Temporary Access Pass
|lifetimeInMinutes|Int32|The lifetime of the Temporary Access Pass in minutes starting at **startDateTime**. Must be between 10 and 43200 inclusive (equivalent to 30 days).| |methodUsabilityReason|String|Details about the usability state (**isUsable**). Reasons can include: `EnabledByPolicy`, `DisabledByPolicy`, `Expired`, `NotYetValid`, `OneTimeUsed`.| |startDateTime|DateTimeOffset|The date and time when the Temporary Access Pass becomes available to use and when **isUsable** is `true` is enforced.|
-|temporaryAccessPass|String|The Temporary Access Pass used to authenticate. Returned only on creation of a new temporaryAccessPass; Hidden in subsequent read operations and returned as `null` with GET.|
+|temporaryAccessPass|String|The Temporary Access Pass used to authenticate. Returned only on creation of a new **temporaryAccessPassAuthenticationMethod** object; Hidden in subsequent read operations and returned as `null` with GET.|
## Relationships None.
v1.0 Temporaryaccesspassauthenticationmethodconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/temporaryaccesspassauthenticationmethodconfiguration.md
doc_type: apiPageType
# temporaryAccessPassAuthenticationMethodConfiguration resource type Namespace: microsoft.graph
-Represents a Temporary Access Pass authentication methods policy that defines the configuration settings and users or groups who are enabled to use the authentication method.
+Represents a Temporary Access Pass authentication methods policy that defines the configuration settings and users or groups who are enabled to use the [Temporary Access Pass authentication method](temporaryaccesspassauthenticationmethod.md).
## Methods |Method|Return type|Description|
Represents a Temporary Access Pass authentication methods policy that defines th
## Properties |Property|Type|Description| |:|:|:|
-|defaultLength|Int|Default length in characters of a temporaryAccessPass. Must be between 8 and 48 characters.|
-|defaultLifetimeInMinutes|Int|Default lifetime in minutes for a temporaryAccessPass. Value can be any integer between the **minimumLifetimeInMinutes** and **maximumLifetimeInMinutes**.|
+|defaultLength|Int|Default length in characters of a Temporary Access Pass object. Must be between 8 and 48 characters.|
+|defaultLifetimeInMinutes|Int|Default lifetime in minutes for a Temporary Access Pass. Value can be any integer between the **minimumLifetimeInMinutes** and **maximumLifetimeInMinutes**.|
|id|String|The identifier of the authentication method policy. Inherited from [entity](entity.md).| |isUsableOnce|Boolean |If `true`, all the passes in the tenant will be restricted to one-time use. If `false`, passes in the tenant can be created to be either one-time use or reusable.|
-|minimumLifetimeInMinutes|Int|Minimum lifetime in minutes for any temporaryAccessPass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).|
-|maximumLifetimeInMinutes|Int|Maximum lifetime in minutes for any temporaryAccessPass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).|
+|minimumLifetimeInMinutes|Int|Minimum lifetime in minutes for any Temporary Access Pass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).|
+|maximumLifetimeInMinutes|Int|Maximum lifetime in minutes for any Temporary Access Pass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).|
|state|authenticationMethodState|Whether the Temporary Access Pass method is enabled in the tenant. Possible values are: `enabled`, `disabled`. Inherited from [authenticationMethodConfiguration](authenticationmethodconfiguration.md). | ## Relationships