+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+description: "Archive a channel in a team."

+You can delete an archived channel or add and remove members from it. If you archive a team, its channels are also archived.

+Archiving is an asynchronous operation; a channel is archived after the asynchronous archiving operation completes successfully, which might occur after the response returns.

+A channel without an owner or that belongs to a [group](../resources/group.md) that has no owner, can't be archived.

+To restore a channel from its archived state, use the [channel: unarchive](channel-unarchive.md) method. A channel canΓÇÖt be archived or unarchived if its team is archived.

+> **Note**: This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't members of.

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Content-Type | application/json. Optional. |

+In the request body, you can optionally provide a JSON object with the following parameter.

+| Parameter | Type |Description|

+|:|:--|:-|

+|shouldSetSpoSiteReadOnlyForMembers|Boolean|Defines whether to set permissions for channel members to read-only on the SharePoint Online site associated with the team. If you set it to `false` or omit the parameter, this step is skipped.|

+The following example shows the request body with **shouldSetSpoSiteReadOnlyForMembers** set to `true`.

+```json

+ "shouldSetSpoSiteReadOnlyForMembers": true

+If archiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header that specifies the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle the archiving of the channel in a team. Check the status of the archiving operation by making a GET request to this location.

+ "name": "archive_channel",

+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]

+POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/archive

+Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba

+The following example shows a request to archive a channel that fails because the team is archived; the team must be active to archive or unarchive a channel.

+<!-- {

+ "blockType": "request",

+ "name": "archive_channel_on_archived_team",

+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]

+}-->

+POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/archive

+The following example shows the `400 Bad Request` response code with a corresponding error message.

+<!-- {

+ "blockType": "response",

+ "name": "archive_channel_on_archived_team",

+ "@odata.type": "microsoft.graph.publicError",

+ "truncated": true

+}-->

+This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't a member of.

+This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't a member of.

+description: "Restore an archived channel in a team."

+Restore an archived [channel](../resources/channel.md). Unarchiving restores the ability for users to send messages and edit the channel. Channels are archived via the [channel: archive](channel-archive.md) method.

+Unarchiving is an asynchronous operation; a channel is unarchived when the asynchronous unarchiving operation completes successfully, which might occur after this method responds.

+> **Note**: An archived channel that belongs to an archived team cannot be unarchived. Unarchive the team before you unarchive the channel; otherwise, the request fails.

+> **Note**: This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't a member of.

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+If unarchiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header that specifies the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle the unarchiving of the channel in a team. Check the status of the unarchiving operation by making a GET request to this location.

+## Examples

+ "name": "unarchive_channel",

+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]

+POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/unarchive

+Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba

+The following example shows a request to unarchive a channel that fails because the team is archived; the team must be active to archive or unarchive a channel.

+<!-- {

+ "blockType": "request",

+ "name": "unarchive_channel_on_archived_team",

+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]

+}-->

+POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/unarchive

+The following example shows the `400 Bad Request` response code with a corresponding error message.

+<!-- {

+ "blockType": "response",

+ "name": "unarchive_channel_on_archived_team",

+ "@odata.type": "microsoft.graph.publicError",

+ "truncated": true

+}-->

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+ "statusDetails": null,

+ "statusDetail": null

+ "statusDetails": null,

+ "statusDetail": null

+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/40cee9d2-03fb-4066-8d35-dbdf2875c33f?$select=id,displayName,imageDisplayName,lastModifiedDateTime,lastRemoteActionResult,lastLoginResult,connectivityResult,allotmentDisplayName,deviceRegionName

+ "allotmentDisplayName": null,

+ "deviceRegionName": "eastus2"

+ "deviceRegionName": "eastus2",

+ "deviceRegionName": "eastus2",

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+> [!NOTE]

+> Sometimes it takes time to reflect the addition of a member after they're added. Users can use [change notifications](../resources/change-notifications-api-overview.md) to subscribe to notifications for membership changes in a particular team.

+The following example shows the response.

+| tenantRestrictions |[crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the default tenant restrictions configuration for users in your organization who access an external organization on your network or devices. |

+| tenantRestrictions |[crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the default tenant restrictions configuration for users in your organization who access an external organization on your network or devices. |

+The following example shows how to configure tenant restrictions settings.

+The following example shows a request.

+ "tenantRestrictions": {

+ "usersAndGroups": {

+ "accessType": "allowed",

+ "targets": [

+ {

+ "target": "AllUsers",

+ "targetType": "user"

+ ]

+ },

+ "applications": {

+ "accessType": "allowed",

+ "targets": [

+ {

+ "target": "Office365",

+ "targetType": "application"

+ }

+ ]

+ }

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+description: "Move a driveItem to a new parent folder."

+ Title: driveItem: move

+# driveItem: move

+Move a [driveItem](../resources/driveitem.md) to a new parent.

+To move a **driveItem** to a new parent item, your app requests an update to the **parentReference** of the **driveItem** to move. The move is a special type of [Update](driveitem-update.md) operation.

+When a **driveItem** is moved within the same site or container, all existing sharing links continue to work. If the **driveItem** is moved to a different site or container, existing sharing links no longer work.

+## Request headers

+|Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| if-match | String | If this request header is included and the eTag (or cTag) provided doesn't match the current eTag on the folder, a `412 Precondition Failed` response is returned. Optional.|

+Existing properties that aren't included in the request body maintain their previous values or the properties are recalculated based on changes to other property values.

+For optimal performance, include only the values that change and omit the unchanged ones.

+> [!NOTE]

+> When items are moved to the root of a drive, your application must use the actual ID of the root folder as the parent reference instead of the `"id: root"` syntax.

+If successful, this method returns a `200 OK` response code and an updated [driveItem](../resources/driveitem.md) resource in the response body.

+For information about how errors are returned, see [Error responses][error-response].

+## Examples

+### Request

+The following example moves an item specified by `{item-id}` into a folder in the user's drive with the ID `new-parent-folder-id`.

+ Title: "Create permission on a driveItem"

+description: "Create a new permission for a driveItem."

+ms.localizationpriority: medium

+# Create permission on a driveItem

+Namespace: microsoft.graph

+Create a new [permission](../resources/permission.md) object on a [driveItem](../resources/permission.md).

+>**Note:** You can only use this method to create a new application permission. If you want to create a new user permission in a drive item, see [invite](./driveitem-invite.md).

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "driveitem_post_permissions" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /drives/{drive-id}/items/{item-id}/permissions

+POST /groups/{group-id}/drive/items/{item-id}/permissions

+POST /me/drive/items/{item-id}/permissions

+POST /sites/{siteId}/drive/items/{itemId}/permissions

+POST /users/{userId}/drive/items/{itemId}/permissions

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [permission](../resources/permission.md) object.

+## Response

+If successful, this method returns a `201 Created` response code and a [permission](../resources/permission.md) object in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "create_permission_from_"

+}

+-->

+### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.permission"

+}

+-->

+``` http

+HTTP/1.1 201 Created

+Content-Type: application/json

+{

+ "id": "1",

+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",

+ "roles": [

+ "write"

+ ],

+ "grantedToIdentities": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ],

+ "grantedToIdentitiesV2": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ]

+}

+```

+<!-- {

+ "type": "#page.annotation",

+ "section": "documentation",

+ "tocPath": "Items/Permissions/Create driveitem permissions"

+} -->

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+ Title: "Delete permission on a list"

+description: "Delete a permission object on a list."

+ms.localizationpriority: medium

+# Delete permission on a list

+Namespace: microsoft.graph

+Delete a [permission](../resources/permission.md) object on a [list](../resources/list.md).

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "list_delete_permissions" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+DELETE /sites/{site-id}/lists/{list-id}/permissions/{permissionId}

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+## Request body

+Don't supply a request body for this method.

+## Response

+If successful, this method returns `204 No Content` response code. It doesn't return anything in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "delete_permission_2"

+}

+-->

+### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+} -->

+```http

+HTTP/1.1 204 No Content

+```

+<!-- {

+ "type": "#page.annotation",

+ "section": "documentation",

+ "tocPath": "Lists/Permissions/Delete list permission"

+} -->

+ Title: "Get permission on a list"

+description: "Retrieve the properties and relationships of a permission object on a list."

+ms.localizationpriority: medium

+# Get permission on a list

+Namespace: microsoft.graph

+Retrieve the properties and relationships of a [permission](../resources/permission.md) object on a [list](../resources/list.md).

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "list_get_permissions" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /sites/{site-id}/lists/{list-id}/permissions/

+```

+## Optional query parameters

+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+## Request body

+Don't supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "get_permission",

+ "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5", "1"]

+}

+-->

+### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.permission"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "id": "1",

+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",

+ "roles": [

+ "read"

+ ],

+ "grantedToIdentities": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ],

+ "grantedToIdentitiesV2": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ]

+}

+```

+<!-- {

+ "type": "#page.annotation",

+ "section": "documentation",

+ "tocPath": "Lists/Permissions/Get list permission"

+} -->

+ Title: "List permissions on a list"

+description: "Get the permission resources from the permissions navigation property on a list."

+ms.localizationpriority: medium

+# List permissions on a list

+Namespace: microsoft.graph

+Get a list of the [permission](../resources/permission.md) objects associated with a [list](../resources/list.md).

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "list_list_permissions" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /sites/{site-id}/lists/{list-id}/permissions

+```

+## Optional query parameters

+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+## Request body

+Don't supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a collection of [permission](../resources/permission.md) objects in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "list_permission_list_nav_property"

+}

+-->

+### Response

+The following example shows the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.permission)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "id": "1",

+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",

+ "roles": [

+ "read"

+ ],

+ "grantedToIdentities": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ],

+ "grantedToIdentitiesV2": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ]

+ },

+ {

+ "id": "2",

+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",

+ "roles": [

+ "write"

+ ],

+ "grantedToIdentities": [

+ {

+ "application": {

+ "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3",

+ "displayName": "Fabrikam Dashboard App"

+ }

+ }

+ ],

+ "grantedToIdentitiesV2": [

+ {

+ "application": {

+ "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3",

+ "displayName": "Fabrikam Dashboard App"

+ }

+ }

+ ]

+ }

+ ]

+}

+```

+<!-- {

+ "type": "#page.annotation",

+ "section": "documentation",

+ "tocPath": "Lists/Permissions/List list permissions"

+} -->

+ Title: "Create permission on a list"

+description: "Create a new permission object."

+ms.localizationpriority: medium

+# Create permission on a list

+Namespace: microsoft.graph

+Create a new [permission](../resources/permission.md) object on a [list](../resources/list.md).

+>**Note:** You can only use this method to create a new application permission; you can't use it to create a new list permission for a user.

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "list_post_permissions" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /sites/f2d90359-865b-4b6c-8848-d2722dd630e5/lists/1d702d60-503c-4924-abfd-028c65fc89ed/permissions

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [permission](../resources/permission.md) object.

+## Response

+If successful, this method returns a `201 Created` response code and a [permission](../resources/permission.md) object in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "create_permission_from_"

+}

+-->

+### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.permission"

+}

+-->

+``` http

+HTTP/1.1 201 Created

+Content-Type: application/json

+{

+ "id": "1",

+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",

+ "roles": [

+ "write"

+ ],

+ "grantedToIdentities": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ],

+ "grantedToIdentitiesV2": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ]

+}

+```

+<!-- {

+ "type": "#page.annotation",

+ "section": "documentation",

+ "tocPath": "Lists/Permissions/Create list permissions"

+} -->

+ Title: "Update permission on a list"

+description: "Update the permission object on a list."

+ms.localizationpriority: medium

+# Update permission on a list

+Namespace: microsoft.graph

+Update the [permission](../resources/permission.md) object on a [list](../resources/list.md).

+>**Note:** You can't use this method to update a list permission for a user.

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "list_update_permissions" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+PATCH /sites/{site-id}/lists/{list-id}/permissions/{permissionId}

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [permission](../resources/permission.md) object.

+## Response

+If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "update_permission_from_",

+ "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5", "2"]

+}

+-->

+### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.permission"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "id": "2",

+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",

+ "roles": [

+ "read"

+ ],

+ "grantedToIdentities": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Fabrikam Dashboard App"

+ }

+ }

+ ],

+ "grantedToIdentitiesV2": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Fabrikam Dashboard App"

+ }

+ }

+ ]

+}

+```

+<!-- {

+ "type": "#page.annotation",

+ "section": "documentation",

+ "tocPath": "Lists/Permissions/Update list permission"

+} -->

+ Title: "Delete permission on a listItem"

+description: "Delete a permission object on a list item."

+ms.localizationpriority: medium

+# Delete permission on a listItem

+Namespace: microsoft.graph

+Delete a [permission](../resources/permission.md) object on a [list item](../resources/listitem.md).

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "listitem_delete_permission" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+DELETE /sites/{site-id}/lists/{list-id}/items/{item-id}/{permissionId}

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+## Request body

+Don't supply a request body for this method.

+## Response

+If successful, this method returns `204 No Content` response code. It doesn't return anything in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "delete_permission_2"

+}

+-->

+### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+} -->

+```http

+HTTP/1.1 204 No Content

+```

+<!-- {

+ "type": "#page.annotation",

+ "section": "documentation",

+ "tocPath": "ListItems/Permissions/Delete listitem permission"

+} -->

+ Title: "Get permission on a listItem"

+description: "Retrieve the properties and relationships of a permission object on a list item."

+ms.localizationpriority: medium

+# Get permission on a listItem

+Namespace: microsoft.graph

+Retrieve the properties and relationships of a [permission](../resources/permission.md) object on a [list item](../resources/listitem.md).

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "listitem_get_permissions" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions/{permission-id}

+```

+## Optional query parameters

+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+## Request body

+Don't supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "get_permission",

+ "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5","f2d90359-865b-4b6c-8848-d2722dd630e5", "1", "3"]

+}

+-->

+### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.permission"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "id": "1",

+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",

+ "roles": [

+ "read"

+ ],

+ "grantedToIdentities": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ],

+ "grantedToIdentitiesV2": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ]

+}

+```

+<!-- {

+ "type": "#page.annotation",

+ "section": "documentation",

+ "tocPath": "ListItems/Permissions/Get listitems permission"

+} -->

+ Title: "List permissions on a listItem"

+description: "Get a list of the permissions objects associated with a list item."

+ms.localizationpriority: medium

+# List permissions on a listItem

+Namespace: microsoft.graph

+Get a list of the [permission](../resources/permission.md) objects associated with a [listItem](../resources/listitem.md).

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "listitem_list_permissions" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions

+```

+## Optional query parameters

+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+## Request body

+Don't supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a collection of [permission](../resources/permission.md) objects in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "list_permission_listitem_nav_property"

+}

+-->

+### Response

+The following example shows the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.permission)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "id": "1",

+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",

+ "roles": [

+ "read"

+ ],

+ "grantedToIdentities": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ],

+ "grantedToIdentitiesV2": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ]

+ },

+ {

+ "id": "2",

+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",

+ "roles": [

+ "write"

+ ],

+ "grantedToIdentities": [

+ {

+ "application": {

+ "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3",

+ "displayName": "Fabrikam Dashboard App"

+ }

+ }

+ ],

+ "grantedToIdentitiesV2": [

+ {

+ "application": {

+ "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3",

+ "displayName": "Fabrikam Dashboard App"

+ }

+ }

+ ]

+ }

+ ]

+}

+```

+<!-- {

+ "type": "#page.annotation",

+ "section": "documentation",

+ "tocPath": "ListItems/Permissions/List listitem permissions"

+} -->

+ Title: "Create permission on a listItem"

+description: "Create a new permission object."

+ms.localizationpriority: medium

+# Create permission on a listItem

+Namespace: microsoft.graph

+Create a new [permission](../resources/permission.md) object on a [list item](../resources/listitem.md).

+>**Note:** You can only use this method to create a new application permission; you can't use it to create a new list item permission for a user.

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "listitem_post_permissions" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [permission](../resources/permission.md) object.

+## Response

+If successful, this method returns a `201 Created` response code and a [permission](../resources/permission.md) object in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "create_permission_from_"

+}

+-->

+### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.permission"

+}

+-->

+``` http

+HTTP/1.1 201 Created

+Content-Type: application/json

+{

+ "id": "1",

+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",

+ "roles": [

+ "write"

+ ],

+ "grantedToIdentities": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ],

+ "grantedToIdentitiesV2": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Contoso Time Manager App"

+ }

+ }

+ ]

+}

+```

+<!-- {

+ "type": "#page.annotation",

+ "section": "documentation",

+ "tocPath": "ListItems/Permissions/Create listitem permissions"

+} -->

+ Title: "Update permission on a listItem"

+description: "Update the permission object on a list item."

+ms.localizationpriority: medium

+# Update permission on a listItem

+Namespace: microsoft.graph

+Update the [permission](../resources/permission.md) object on a [list item](../resources/listitem.md).

+>**Note:** You can't use this method to update a user listitem permission.

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "listitem_update_permissions" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions/{permission-id}

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [permission](../resources/permission.md) object.

+## Response

+If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "update_permission_from_",

+ "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5", "2"]

+}

+-->

+### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.permission"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "id": "2",

+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",

+ "roles": [

+ "read"

+ ],

+ "grantedToIdentities": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Fabrikam Dashboard App"

+ }

+ }

+ ],

+ "grantedToIdentitiesV2": [

+ {

+ "application": {

+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",

+ "displayName": "Fabrikam Dashboard App"

+ }

+ }

+ ]

+}

+```

+<!-- {

+ "type": "#page.annotation",

+ "section": "documentation",

+ "tocPath": "ListItems/Permissions/Update listitem permission"

+} -->

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+In some cases, an app wants to retrieve subscriptions created by other apps. For example, a user wants to see all subscriptions created by any app on their behalf. Or, a Global Administrator who wants to see all subscriptions from all apps in their directory.

+| App is calling on behalf of the signed-in user (delegated permission). *The user is a Global Administrator*.<br/>-and-<br/>App has the permission Subscription.Read.All<br/><br/>Note: This scenario only applies to work/school accounts. | Subscriptions created by **any app** for **any user** in the directory.|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+> * The **roles** property is empty by default for all members. This property only contains additional qualifiers when relevant; for example, if the member has `owner` privileges, the **roles** property contains `owner` as one of the values. Similarly, if the member is a guest, the **roles** property contains `guest` as one of the values. A basic member shouldn't have any values specified in the **roles** property.

+> * After adding a new [conversation member](../resources/conversationmember.md) to a [team](../resources/team.md), it might take some time for the addition to be reflected. Users can use [change notifications](../resources/change-notifications-api-overview.md) to subscribe to notifications for membership changes in a particular team.

+For best results, stagger calls with a 2-second buffer.

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+ "deviceRegionName": "eastus2",

+ "deviceRegionName": "eastus2",

+ "deviceRegionName": "eastus2",

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+ Title: "virtualEventRegistration: cancel"

+description: "Cancel a registrant's registration record for a webinar."

+ms.localizationpriority: medium

+# virtualEventRegistration: cancel

+Namespace: microsoft.graph

+Cancel a registrant's [registration record](../resources/virtualeventregistration.md) for a [webinar](../resources/virtualeventwebinar.md).

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+<!-- {

+ "blockType": "permissions",

+ "name": "virtualeventregistration-cancel-permissions"

+}

+-->

+> [!NOTE]

+> - Use delegated permissions to cancel a registration record for a person who has a [Microsoft Entra ID](https://learn.microsoft.com/entra/fundamentals/whatis).

+> - Use application permissions to cancel a registration record for an anonymous user.

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /solutions/virtualEvents/webinars/{webinarId}/registrations/{registrationId}/cancel

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+## Request body

+Don't supply a request body for this method.

+## Response

+If successful, this action returns a `204 No Content` response code.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "virtualeventregistrationthis.cancel"

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations/127962bb-84e1-7b62-fd98-1c9d39def7b6/cancel

+```

+### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ Title: "List sessions"

+description: "Get a list of sessions that a registrant registered for in a webinar."

+ms.localizationpriority: medium

+# List sessions

+Namespace: microsoft.graph

+Get a list of [sessions](../resources/virtualeventsession.md) that a registrant registered for in a [webinar](../resources/virtualeventwebinar.md).

+> [!NOTE]

+>

+> Currently, this API only supports single session webinars and returns a single session.

+## 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).

+<!-- {

+ "blockType": "permissions",

+ "name": "virtualeventregistration-list-sessions-permissions"

+}

+-->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /solutions/virtualEvents/webinars/{webinarId}/registrations/{registrationId}/sessions

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a collection of [virtualEventSession](../resources/virtualeventsession.md) objects in the response body.

+> [!NOTE]

+>

+> Currently, this API is only able to return the session summary, which is a partial representation of the full session object.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "list_virtualeventregistrationsessions"

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations/127962bb-84e1-7b62-fd98-1c9d39def7b6/sessions

+```

+### Response

+The following example shows the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.virtualEventSession)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.virtualEventSession",

+ "id": "8d62dd52-4dff-4c75-96a9-f905cc3ff942",

+ "startDateTime": "2023-08-08T12:30:00Z",

+ "endDateTime": "2023-08-09T22:00:00Z",

+ "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_ZDVjNzk3OWEtYjc2NS00NTA1LTkyMzQtYTYzMGI5YmFmMjM5%40thread.v2/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%221cd068e4-5b08-4e75-a7f9-7b4e067a0820%22%7d",

+ "subject": "Session one",

+ "isBroadcast": null,

+ "broadcastSettings": null,

+ "capabilities": [],

+ "audioConferencing": null,

+ "chatInfo": null,

+ "videoTeleconferenceId": null,

+ "externalId": null,

+ "joinMeetingIdSettings": null,

+ "lobbyBypassSettings": null,

+ "isEntryExitAnnounced": null,

+ "allowedPresenters": null,

+ "allowAttendeeToEnableMic": null,

+ "allowAttendeeToEnableCamera": null,

+ "allowMeetingChat": null,

+ "shareMeetingChatHistoryDefault": null,

+ "allowTeamworkReactions": null,

+ "recordAutomatically": null,

+ "watermarkProtection": null,

+ "allowParticipantsToChangeName": null

+ }

+ ]

+}

+```

+GET /solutions/virtualEvents/webinars/{webinarId}/registrations?$filter=userId eq '{userId}'

+GET /solutions/virtualEvents/webinars/{webinarId}/registrations?$filter=email eq '{email}'

+This method supports a filter from the [OData query parameters](/graph/query-parameters) to help customize the response.

+## Function parameters

+In the request URL, you can provide either of the following query parameters with values.

+|Parameter|Type|Description|

+|:|:|:|

+|userId|String|The ID of the specified user in Microsoft Entra.|

+|email|String|The email address of the specified user registered to the webinar.|

+If you fetch a virtual event registration by **userId** or **email**, this method returns a collection that contains only one [virtualEventRegistration](../resources/virtualeventregistration.md) object in the response body.

+### Example 1: Retrieve a list of virtual event registrations

+#### Request

+#### Response

+ "preferredTimezone":"Pacific Standard Time",

+ "preferredLanguage":"en-us",

+ "registrationQuestionAnswers": [

+ {

+ "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",

+ "displayName": "Which city do you currently work in?",

+ "value": null,

+ "booleanValue": null,

+ "multiChoiceValues": [

+ "Seattle"

+ ]

+ },

+ {

+ "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",

+ "displayName": "Do you in the same city where you work?",

+ "value": null,

+ "booleanValue": true,

+ "multiChoiceValues": []

+ },

+ {

+ "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",

+ "displayName": "Which cities have you worked in?",

+ "value": null,

+ "booleanValue": null,

+ "multiChoiceValues": [

+ "Cancun",

+ "Hoboken",

+ "Beijing"

+ ]

+ }

+ ]

+ }

+ ]

+}

+```

+### Example 2: Retrieve a virtual event registration by user ID

+#### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "virtualeventregistration-get-byuserid"

+}

+-->

+```http

+GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations?$filter=userId eq 'b7ef013a-c73c-4ec7-8ccb-e56290f45f68'

+```

+#### Response

+The following example shows the response.

+> **Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.virtualEventRegistration)"

+} -->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.virtualEventRegistration",

+ "id": "127962bb-84e1-7b62-fd98-1c9d39def7b6",

+ "userId": "String",

+ "firstName": "Emilee",

+ "lastName": "Pham",

+ "email": "EmileeMPham@contoso.com",

+ "status": "registered",

+ "registrationDateTime": "2023-03-07T22:04:17",

+ "cancelationDateTime": null,

+ "preferredTimezone":"Pacific Standard Time",

+ "preferredLanguage":"en-us",

+ "registrationQuestionAnswers": [

+ {

+ "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",

+ "displayName": "Which city do you currently work in?",

+ "value": null,

+ "booleanValue": null,

+ "multiChoiceValues": [

+ "Seattle"

+ ]

+ },

+ {

+ "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",

+ "displayName": "Do you in the same city where you work?",

+ "value": null,

+ "booleanValue": true,

+ "multiChoiceValues": []

+ },

+ {

+ "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",

+ "displayName": "Which cities have you worked in?",

+ "value": null,

+ "booleanValue": null,

+ "multiChoiceValues": [

+ "Cancun",

+ "Hoboken",

+ "Beijing"

+ ]

+ }

+ ]

+ }

+ ]

+}

+```

+### Example 3: Retrieve a virtual event registration by email

+#### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "virtualeventregistration-get-byemail"

+}

+-->

+```http

+GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations?$filter=email eq 'EmileeMPham@contoso.com'

+```

+#### Response

+The following example shows the response.

+> **Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.virtualEventRegistration)"

+} -->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.virtualEventRegistration",

+ "id": "127962bb-84e1-7b62-fd98-1c9d39def7b6",

+ "userId": "String",

+ "firstName": "Emilee",

+ "lastName": "Pham",

+ "email": "EmileeMPham@contoso.com",

+ "status": "registered",

+ "registrationDateTime": "2023-03-07T22:04:17",

+ "cancelationDateTime": null,

+ "preferredTimezone":"Pacific Standard Time",

+ "preferredLanguage":"en-us",

+ Title: "Create virtualEventRegistration"

+description: "Create a registration record for a webinar registrant."

+ms.localizationpriority: medium

+# Create virtualEventRegistration

+Namespace: microsoft.graph

+Create a [registration record](../resources/virtualeventregistration.md) for a registrant of a [webinar](../resources/virtualeventwebinar.md). This method registers the person for the webinar.

+## 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).

+<!-- {

+ "blockType": "permissions",

+ "name": "virtualeventregistration-post-permissions"

+}

+-->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /solutions/virtualEvents/webinars/{webinarId}/registrations

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+## Request body

+In the request body, supply a JSON representation of a [virtualEventRegistration](../resources/virtualeventregistration.md) object.

+## Response

+If successful, this action returns one of the following:

+* A `201 Created` response code and [virtualEventRegistration](../resources/virtualeventregistration.md) object for delegated permissions.

+* A `204 No Content` response code for application permissions.

+## Examples

+### Example 1: Creating registration record with delegated permission

+Use delegated permission to create a registration record for a person who has a [Microsoft Entra ID](https://learn.microsoft.com/entra/fundamentals/whatis) as a way to register a Microsoft Entra user to a webinar.

+#### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "create-virtualeventregistration-delegated",

+ "@odata.type": "microsoft.graph.virtualEventRegistration"

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations

+Content-Type: application/json

+{

+ "preferredTimezone":"Pacific Standard Time",

+ "preferredLanguage":"en-us",

+ "registrationQuestionAnswers": [

+ {

+ "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",

+ "value": null,

+ "booleanValue": null,

+ "multiChoiceValues": [

+ "Seattle"

+ ]

+ },

+ {

+ "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",

+ "value": null,

+ "booleanValue": true,

+ "multiChoiceValues": []

+ },

+ {

+ "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",

+ "value": null,

+ "booleanValue": null,

+ "multiChoiceValues": [

+ "Cancun",

+ "Hoboken",

+ "Beijing"

+ ]

+ }

+ ]

+}

+```

+#### Response

+The following example shows the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.virtualEventRegistration"

+}

+-->

+``` http

+HTTP/1.1 201 Created

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.virtualEventRegistration",

+ "id": "127962bb-84e1-7b62-fd98-1c9d39def7b6",

+ "userId": "String",

+ "firstName": "Emilee",

+ "lastName": "Pham",

+ "email": "EmileeMPham@contoso.com",

+ "status": "registered",

+ "registrationDateTime": "2023-03-07T22:04:17",

+ "cancelationDateTime": null,

+ "preferredTimezone":"Pacific Standard Time",

+ "preferredLanguage":"en-us",

+ "registrationQuestionAnswers": [

+ {

+ "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",

+ "displayName": "Which city do you currently work in?",

+ "value": null,

+ "booleanValue": null,

+ "multiChoiceValues": [

+ "Seattle"

+ ]

+ },

+ {

+ "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",

+ "displayName": "Do you live in the same city where you work?",

+ "value": null,

+ "booleanValue": true,

+ "multiChoiceValues": []

+ },

+ {

+ "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",

+ "displayName": "Which cities have you worked in?",

+ "value": null,

+ "booleanValue": null,

+ "multiChoiceValues": [

+ "Cancun",

+ "Hoboken",

+ "Beijing"

+ ]

+ }

+ ]

+}

+```

+### Example 2: Creating registration record with application permission

+Use application permission to create a registration record for a person who does not have a [Microsoft Entra ID](https://learn.microsoft.com/entra/fundamentals/whatis) as a way to register an anonymous user for a webinar.

+#### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "create-virtualeventregistration-application",

+ "@odata.type": "microsoft.graph.virtualEventRegistration"

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations

+Content-Type: application/json

+{

+ "firstName" : "Diane",

+ "lastName" : "Demoss",

+ "email" : "DianeDemoss@contoso.com",

+ "preferredTimezone":"Pacific Standard Time",

+ "preferredLanguage":"en-us",

+ "registrationQuestionAnswers": [

+ {

+ "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",

+ "value": null,

+ "booleanValue": null,

+ "multiChoiceValues": [

+ "Seattle"

+ ]

+ },

+ {

+ "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",

+ "value": null,

+ "booleanValue": true,

+ "multiChoiceValues": []

+ },

+ {

+ "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",

+ "value": null,

+ "booleanValue": null,

+ "multiChoiceValues": [

+ "London",

+ "New York City"

+ ]

+ }

+ ]

+}

+```

+#### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ Title: "List questions"

+description: "Get a list of all registration questions for a webinar."

+ms.localizationpriority: medium

+# List questions

+Namespace: microsoft.graph

+Get a list of all [registration](../resources/virtualeventregistration.md) questions for a [webinar](../resources/virtualeventwebinar.md).

+The list can include either [predefined registration questions](../resources/virtualeventregistrationpredefinedquestion.md) or [custom registration questions](../resources/virtualeventregistrationcustomquestion.md).

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "virtualeventregistrationconfiguration_list_questions" } -->

+> [!NOTE]

+>

+> To use application permissions for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and assign it to a user. This allows the authorized application to access registration records from virtual events created by that specific user.

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration/questions

+```

+## Optional query parameters

+This method does not support OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+## Request body

+Don't supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a collection of [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) or [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md) objects, or both in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "list_questions_virtualeventregistration"

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrationConfiguration/questions

+```

+### Response

+The following example shows the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.virtualEventRegistrationQuestionBase)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.virtualEventRegistrationPredefinedQuestion",

+ "id": "630ce4da-6355-459e-81dc-541fd6b93375",

+ "displayName": "Job title",

+ "isRequired": true,

+ "label": "jobTitle"

+ },

+ {

+ "@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",

+ "id": "363dc852-452d-4e51-a1f8-a8dc72ce82cd",

+ "displayName": "In what area do you work",

+ "isRequired": false,

+ "answerInputType": "text",

+ "answerChoices": []

+ },

+ {

+ "@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",

+ "id": "e4ef3e86-9137-4d24-8440-c674f1a3df7b",

+ "displayName": "What is your primary reason for attending this webinar",

+ "isRequired": true,

+ "answerInputType": "singleChoice",

+ "answerChoices": [

+ "To gain knowledge on the topic",

+ "To network with other professionals",

+ "To earn continuing education credits"

+ ]

+ },

+ {

+ "@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",

+ "id": "e36b964f-2aed-43cf-a13e-2df4f8624652",

+ "displayName": "Are you interested in webinars of the same topic in the future",

+ "isRequired": true,

+ "answerInputType": "boolean",

+ "answerChoices": []

+ }

+ ]

+}

+```

+<!-- {

+ "type": "#page.annotation",

+ "suppressions": [

+ "Error: listquestionsvirtualeventregistration/container/answerInputType:

+ Expected type String but actual was Boolean. Property: answerInputType, actual value: 'boolean'"

+ ]

+}-->

+ Title: "Create question"

+description: "Create a registration question for a webinar."

+ms.localizationpriority: medium

+# Create question

+Namespace: microsoft.graph

+Create a [registration question](../resources/virtualeventregistrationquestionbase.md) for a [webinar](../resources/virtualeventwebinar.md).

+You can create either a [predefined registration question](../resources/virtualeventregistrationpredefinedquestion.md) or a [custom registration question](../resources/virtualeventregistrationcustomquestion.md).

+## Permissions

+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

+<!-- { "blockType": "permissions", "name": "virtualeventregistration_post_question" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration/questions

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of etiher a [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) or a [virtualEventRegistrationPredefinedQuestion](../resources/virtualEventRegistrationPredefinedQuestion.md) object.

+You can specify the following properties when you create a **virtualEventRegistrationCustomQuestion**.

+|Property|Type|Description|

+|:|:|:|

+|answerChoices|String collection|Answer choices when **answerInputType** is `singleChoice` or `multiChoice`. |

+|answerInputType|virtualEventRegistrationQuestionAnswerInputType|Input type of the registration question answer. The supported values are `text`, `multilineText`, `singleChoice`, `multiChoice`, and `boolean`.|

+|displayName|String|Display name of the registration question.|

+|isRequired|Boolean| Indicates whether an answer to the question is required. Default value is `false`.|

+You can specify the following property when you create a **virtualEventRegistrationPredefinedQuestion**.

+|Property|Type|Description|

+|:|:|:|

+|label|virtualEventRegistrationPredefinedQuestionLabel|Label of the predefined registration question. The following label values accept a single line of text: `street`, `city`, `state`, `postalCode`, `countryOrRegion`, `industry`, `jobTitle`, and `organization`. `unknownFutureValue` is an evolvable enumeration sentinel value; do not use this label.|

+## Response

+If successful, this method returns a `201 Created` response code and either a [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) or [virtualEventRegistrationPredefinedQuestion](../resources/virtualEventRegistrationPredefinedQuestion.md) object in the response body.

+## Examples

+### Example 1: Add a custom registration question to a webinar registration

+#### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "post_custom_question_virtualeventregistration"

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrationConfiguration/questions

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",

+ "displayName": "What's your job position?",

+ "answerInputType": "multiChoice",

+ "answerChoices": [

+ "Software Engineer",

+ "Engineer Manager",

+ "Product Manager"

+ ],

+}

+```

+#### Response

+The following example shows the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.virtualEventRegistrationCustomQuestion"

+}

+-->

+```http

+HTTP/1.1 201 Created

+Content-type: application/json

+{

+ "@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",

+ "id": "f3115d4c-9896-42fc-a649-8ca5e3c3a43f",

+ "displayName": "What's your job position?",

+ "answerInputType": "multiChoice",

+ "answerChoices": [

+ "Software Engineer",

+ "Engineer Manager",

+ "Product Manager"

+ ],

+ "isRequired": false

+}

+```

+### Example 2: Add a predefined registration question to a webinar registration

+#### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "post_predefined_question_virtualeventregistration"

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrationConfiguration/questions

+```

+``` http

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.virtualEventRegistrationPredefinedQuestion",

+ "label": "street"

+}

+```

+#### Response

+The following example shows the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.virtualEventRegistrationPredefinedQuestion"

+}

+-->

+```http

+HTTP/1.1 201 Created

+Content-type: application/json

+{

+ "@odata.type": "#microsoft.graph.virtualEventRegistrationPredefinedQuestion",

+ "id": "7a852983-013a-4062-9e97-f784c6a57ec8",

+ "label": "street",

+ "displayName": "Address",

+ "isRequired": false

+}

+```

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|[Apply decisions](../api/accessreview-apply.md) | None. | Apply the decisions from a completed accessReview. |

+|[Generate download URI](../api/accessreviewhistoryinstance-generatedownloaduri.md)|[accessReviewHistoryDefinition](accessreviewhistorydefinition.md)|Generates a URI that can be used to retrieve the instance's review history data.|

+| [List audio routing groups](../api/call-list-audioroutinggroups.md) | [audioRoutingGroup](audioroutinggroup.md) collection | Get an **audioRoutingGroup** object collection. |

+|[Get operation on chat](../api/teamsasyncoperation-get.md) | [teamsAsyncOperation](teamsAsyncOperation.md) | Get a single async operation that ran or is running on the chat.|

+|[Get shift work access state (deprecated)](../api/cloudpc-getshiftworkcloudpcaccessstate.md) |[shiftWorkCloudPcAccessState](#shiftworkcloudpcaccessstate-values-deprecated)|Get the access state of the shift work Cloud PC. The possible values are: `unassigned`, `noLicensesAvailable`, `activationFailed`, `active`, `activating`, `waitlisted`, `unknownFutureValue`, `standbyMode`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this evolvable enum: `standbyMode`. This API is deprecated and will stop returning data on December 31, 2023. Going forward, use the [getFrontlineCloudPcAccessState](../api/cloudpc-getfrontlinecloudpcaccessstate.md) API.|

+|deviceRegionName|String|The name of the geographical region where the Cloud PC is currently provisioned. For example, `westus3`, `eastus2`, and `southeastasia`. Read-only.|

+|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|The type of licenses to be used when provisioning Cloud PCs using this policy. Possible values are: `dedicated`, `shared`, `unknownFutureValue`,`sharedByUser`, `sharedByEntraGroup`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `sharedByUser`, `sharedByEntraGroup`. The default value is `dedicated`. CAUTION: The `shared` member is deprecated and will stop returning on April 30, 2027； in the future, use the `sharedByUser` member. |

+|status|[microsoft.graph.cloudPcStatus](#cloudpcstatus-values)|The status of the Cloud PC. Possible values are: `notProvisioned`, `provisioning`, `provisioned`, `inGracePeriod`, `deprovisioning`, `failed`, `provisionedWithWarnings`, `resizing`, `restoring`, `pendingProvision`, `unknownFutureValue`, `movingRegion`, `resizePendingLicense`, `modifyingSingleSignOn`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `movingRegion`, `resizePendingLicense`, `modifyingSingleSignOn`.|

+|statusDetails (deprecated)|[cloudPcStatusDetails](../resources/cloudpcstatusdetails.md)|The details of the Cloud PC status. For example, `{ "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }`. This property is deprecated and will no longer be supported effective August 31, 2024. Use statusDetail instead.|

+|statusDetail|[cloudPcStatusDetail](../resources/cloudpcstatusdetail.md)|Indicates the detailed status associated with Cloud PC, including error/warning code, error/warning message, additionalInformation. For example, `{ "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }`. |

+|connectionSetting|[cloudPcConnectionSetting](../resources/cloudpcconnectionsetting.md)|The connection setting of the Cloud PC. Possible values: `enableSingleSignOn`. Read Only.|

+The following table lists the members of an [evolvable enumeration](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations). Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following values in this evolvable enum: `movingRegion`, `resizePendingLicense`, `modifyingSingleSignOn`.

+|modifyingSingleSignOn|Indicates that the Cloud PC is updating the single sign on setting.|

+ "deviceRegionName": "String",

+ "resourceType": "String"

+ Title: "cloudPcConnectionSetting resource type"

+description: "The connection setting of a Cloud PC. Currently, only enableSingleSignOn is supported."

+ms.localizationpriority: medium

+# cloudPcConnectionSetting resource type

+Namespace: microsoft.graph

+The connection setting of a Cloud PC. Currently, only **enableSingleSignOn** is supported. IT admins can enable it by updating the provisioning policy and calling [applyConfig](../api/cloudpcprovisioningpolicy-applyconfig.md)/[apply](../api/cloudpcprovisioningpolicy-apply.md) API.

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|enableSingleSignOn|Boolean|Indicates whether single sign-on is enabled. The default value is `false`.|

+## Relationships

+None.

+## JSON representation

+The following JSON representation shows the resource type.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.cloudPcConnectionSetting",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.cloudPcConnectionSetting",

+ "enableSingleSignOn": "false",

+}

+```

+|failedHealthCheckItems|[cloudPcHealthCheckItem](../resources/cloudpchealthcheckitem.md) collection|A list of failed health check items. If the status property is `available`, this property is empty.|

+|updatedDateTime (deprecated)|string|Datetime when the status was updated. This property is deprecated and will no longer be supported effective August 31, 2024. Use lastModifiedDateTime instead. Read-Only.|

+|lastModifiedDateTime|string|The last modified time for connectivity status of the Cloud PC. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: `2014-01-01T00:00:00Z`. |

+|unknownFutureValue|999|Evolvable enumeration sentinel value. Don't use.|

+The following JSON representation shows the resource type.

+ "updatedDateTime": "String (timestamp)",

+ "lastModifiedDateTime": "String (timestamp)"

+description: "Represents a remote action result specified by a Cloud PC."

+Represents a remote action result specified by a Cloud PC.

+|statusDetail|[cloudPcStatusDetail](../resources/cloudpcstatusdetail.md)|The extended details of the action status, including error code, error message, and additional information. For example, `"statusDetail": {"code": "internalServerError","message": "There was an internal server error. Please contact support xxx.","additionalInformation": [ { "@odata.type":"microsoft.graph.keyValuePair","name": "correlationId","value": "52367774-cfb7-4e9c-ab51-1b864c31f2d1"} ]}` |

+|statusDetails (deprecated)|[cloudPcStatusDetails](../resources/cloudpcstatusdetails.md)|The details of the Cloud PC status. This property is deprecated and will no longer be supported effective August 31, 2024. Use statusDetail instead. |

+|pending|The action is pending.|

+|canceled|The action is canceled.|

+|active|The action is active.|

+|done|The action completed without errors.|

+|failed|The action failed.|

+|notSupported|The action isn't supported.|

+ },

+ "statusDetail": {

+ "@odata.type": "microsoft.graph.cloudPcStatusDetail"

+ Title: "cloudPcStatusDetail resource type"

+description: "Describes the extended detail of the Cloud PC status or action status, including code, message, and additional information."

+ms.localizationpriority: medium

+# cloudPcStatusDetail resource type

+Namespace: microsoft.graph

+Describes the extended detail of the Cloud PC status or action status, including code, message, and additional information.

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|code|String|The error/warning code associated with the Cloud PC status. Example: `"code": "internalServerError"`.|

+|message|String|The status message associated with error code. Example: `"message": "There was an internal server error. Please contact support xxx."`. |

+|additionalInformation|[keyValuePair](../resources/keyvaluepair.md) collection|More information about the Cloud PC status. For example, `"additionalInformation": ["{'@odata.type': 'microsoft.graph.keyValuePair','name': 'retriable','value': true }] "`|

+## Relationships

+None.

+## JSON representation

+The following JSON representation shows the resource type.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.cloudPcStatusDetail",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.cloudPcStatusDetail",

+ "code": "String",

+ "message": "String",

+ "additionalInformation": [

+ {

+ "@odata.type": "microsoft.graph.keyValuePair"

+ }

+ ]

+}

+```

+ Title: "cloudPcStatusDetails resource type (deprecated)"

+# cloudPcStatusDetails resource type (deprecated)

+Represents details about a Cloud PC status.

+> [!NOTE]

+> This resource type is deprecated and will stop returning data on August 31, 2024. Use [cloudPcStatusDetail](../resources/cloudpcstatusdetail.md) instead.

+The following JSON representation shows the resource type.

+ + In Microsoft Entra B2B collaboration, both inbound and outbound access settings are enabled by default. This default configuration means all your users can be invited to external organizations, and all your users can invite guest users.

+description: "Represents the default configuration for cross-tenant access and tenant restrictions."

+Represents the default configuration for cross-tenant access and tenant restrictions. Cross-tenant access settings include inbound and outbound settings of Microsoft Entra B2B collaboration and B2B direct connect.

+| tenantRestrictions |[crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the default tenant restrictions configuration for users in your organization who access an external organization on your network or devices. |

+The following JSON representation shows the resource type.

+ "automaticUserConsentSettings": {"@odata.type": "microsoft.graph.inboundOutboundPolicyConfiguration"},

+ "b2bCollaborationInbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"},

+ "b2bCollaborationOutbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"},

+ "b2bDirectConnectInbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"},

+ "b2bDirectConnectOutbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"},

+ "inboundTrust": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyInboundTrust"},

+ "invitationRedemptionIdentityProviderConfiguration": {"@odata.type": "microsoft.graph.defaultInvitationRedemptionIdentityProviderConfiguration"},

+ "isServiceDefault": "Boolean",

+ "tenantRestrictions": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyTenantRestrictions"}

+description: "Represents the partner-specific configuration for cross-tenant access and tenant restrictions."

+Represents the partner-specific configuration for cross-tenant access and tenant restrictions. Cross-tenant access settings include inbound and outbound settings of Microsoft Entra B2B collaboration and B2B direct connect.

+For any partner-specific property that is `null`, these settings inherit the behavior configured in your [default cross-tenant access settings](../resources/crosstenantaccesspolicyconfigurationdefault.md).

+| tenantRestrictions | [crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the partner-specific tenant restrictions configuration for users in your organization who access a partner organization using partner supplied identities on your network or devices. |

+ "automaticUserConsentSettings": {"@odata.type": "microsoft.graph.inboundOutboundPolicyConfiguration"},

+ "b2bCollaborationInbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"},

+ "b2bCollaborationOutbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"},

+ "b2bDirectConnectInbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"},

+ "b2bDirectConnectOutbound": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"},

+ "inboundTrust": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyInboundTrust"},

+ "isServiceProvider": "Boolean",

+ "tenantId": "String (identifier)",

+ "tenantRestrictions": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyTenantRestrictions"}

+| target | String | Defines the target for cross-tenant access policy settings and can have one of the following values: <li> The unique identifier of the user, group, or application <li> `AllUsers` <li> `AllApplications` - Refers to any [Microsoft cloud application](/azure/active-directory/conditional-access/concept-conditional-access-cloud-apps#microsoft-cloud-applications). <li> `Office365` - Includes the applications mentioned as part of the [Office 365](/azure/active-directory/conditional-access/concept-conditional-access-cloud-apps#office-365) suite. |

+|devices|[devicesFilter](../resources/devicesfilter.md)|Defines the rule for filtering devices and whether devices satisfying the rule should be allowed or blocked. This property isn't supported on the server side yet.|

+The following JSON representation shows the resource type.

+ "applications": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyTargetConfiguration"},

+ "devices": {"@odata.type": "microsoft.graph.devicesFilter"},

+ "usersAndGroups": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyTargetConfiguration"}

+|[Validate authentication configuration](../api/customauthenticationextension-validateauthenticationconfiguration.md)|[authenticationConfigurationValidation](../resources/authenticationconfigurationvalidation.md)|Check the validity of the endpoint and authentication configuration for a [customAuthenticationExtension](../resources/customauthenticationextension.md) object.|

+description: "Defines a rule to filter the devices and whether devices that satisfy the rule should be allowed or blocked."

+Defines a rule to filter the devices and whether devices that satisfy the rule should be allowed or blocked.

+|mode|crossTenantAccessPolicyTargetConfigurationAccessType|Determines whether devices that satisfy the rule should be allowed or blocked. The possible values are: `allowed`, `blocked`, `unknownFutureValue`.|

+The following JSON representation shows the resource type.

+| Method | Return Type | Description |

+|:--|:|:-|

+| [Get item](../api/driveitem-get.md) | [driveItem](../resources/driveitem.md) |Retrieve the metadata for a **driveItem** in a drive.|

+| [Get analytics][] | [itemAnalytics][] | Get analytics for this resource.|

+| [Get activities by interval][] | [itemActivityStat](../resources/itemactivitystat.md) | Get a collection of **itemActivityStats** within the specified time interval.|

+| [List children](../api/driveitem-list-children.md) | [driveItem](../resources/driveitem.md) collection | Return a collection of **driveItems** in the children relationship of a **driveItem**.|

+| [List versions](../api/driveitem-list-versions.md) | [driveItemVersion][] collection | Retrieve the versions of a file in the current user's drive.|

+| [Create folder](../api/driveitem-post-children.md) | [driveItem](../resources/driveitem.md) | Create a **driveItem** in the specified drive.|

+| [Update item](../api/driveitem-update.md) | [driveItem](../resources/driveitem.md) | Update a **driveItem** in the drive.|

+| [Upload](../api/driveitem-put-content.md) | [driveItem](../resources/driveitem.md) | Upload content to the **driveItem**.|

+| [Download file content](../api/driveitem-get-contentstream.md) | Stream |Download the contents of the primary stream (file) of a **driveItem**. |

+| [Download specific file format][download-format] | download URL | Download content of a **driveItem** with a specific format.|

+| [Delete item](../api/driveitem-delete.md) | None | Delete a **driveItem**.|

+| [Permanently delete item](../api/driveitem-permanentdelete.md) | None | Permanently delete a **driveItem** by using its ID. |

+| [Move item](../api/driveitem-move.md) | [driveItem](../resources/driveitem.md) | Move a **driveItem** to a new parent item.|

+| [Copy item](../api/driveitem-copy.md) | details about how to [monitor the progress](/graph/long-running-actions-overview) of the copy | Create a copy of a **driveItem** (including any children).|

+| [Search items](../api/driveitem-search.md) | [driveItem](../resources/driveitem.md) collection | Search the hierarchy of items for items matching a query.|

+| [Track changes](../api/driveitem-delta.md) | delta link | List any changes in the drive.|

+| [Follow item](../api/driveitem-follow.md) | [driveItem](../resources/driveitem.md) | Follow a **driveItem**.|

+| [Unfollow item](../api/driveitem-unfollow.md) | None | Unfollow a **driveItem**.|

+| [Get thumbnails](../api/driveitem-list-thumbnails.md) | [driveItem](../resources/driveitem.md) collection | List **driveItems** with their thumbnails.|

+| [Create sharing link](../api/driveitem-createlink.md) | sharing link | Create a link to share the **driveItem**.|

+| [Add permissions](../api/driveitem-invite.md) | [permission][] collection | Send a sharing invite to a user.|

+| [List permissions](../api/driveitem-list-permissions.md) | [permission][] collection | Retrieve the collection of permissions on a **driveItem**.|

+| [Create permission](../api/driveitem-post-permissions.md) | [permission][] | Create a permission on a **driveItem**.|

+| [Delete permission](../api/permission-delete.md) | None | Remove the permission from the **driveItem**.|

+| [Revoke grants on sharing link](../api/permission-revokegrants.md)| [permission][] | Revoke access to a **listItem** or **driveItem** granted via a sharing link by removing the specified recipient from the link.|

+| [Get WebSocket channel][getWebSocket] | [subscription][] | Receive near-real-time change notifications for a drive using socket.io.|

+| [Preview item][item-preview] | json object | Obtain short-lived embeddable URLs for an item in order to render a temporary preview.|

+| [Check in files](../api/driveitem-checkin.md) | None| Check in a checked out **driveItem** resource, which makes the version of the document available to others. |

+| [Check out files](../api/driveitem-checkout.md) | None| Check out a **driveItem** resource to prevent others from editing the document, and prevent your changes from being visible until the documented is [checked in](../api/driveitem-checkin.md). |

+| [Extract sensitivity labels](../api/driveitem-extractsensitivitylabels.md) | [extractSensitivityLabelsResult](../resources/extractsensitivitylabelsresult.md) | Extract one or more sensitivity labels assigned to a drive item and update the metadata of a drive item with the latest details of the assigned label. |

+| [Assign sensitivity label](../api/driveitem-assignsensitivitylabel.md) | String | Asynchronously assign a sensitivity label to a **driveItem**.|

+| [Get retention label](../api/driveitem-getretentionlabel.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Get metadata information for a retention label applied on a **driveItem**. |

+| [Set retention label](../api/driveitem-setretentionlabel.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Apply (set) a retention label on a **driveItem** (files and folders). |

+| [Remove retention label](../api/driveitem-removeretentionlabel.md) | None | Remove a retention label from a **driveItem**. |

+| [Lock or unlock record](../api/driveitem-lockorunlockrecord.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Lock or unlock a retention label on a **driveItem** that classifies content as records. |

+| [Download file (deprecated)](../api/driveitem-get-content.md) | download URL | Download content of a **driveItem**.|

+|[Get](../api/dynamics-countriesregions-get.md) |countryRegion|Get a Countries/Regions. |

+|[Create](../api/dynamics-create-countriesregions.md) |countryRegion|Create a Countries/Regions.|

+|[Patch](../api/dynamics-countriesregions-update.md) |countryRegion|Update a Countries/Regions.|

+|[Delete](../api/dynamics-countriesregions-delete.md)|none |Delete a Countries/Regions.|

+|[List site sources](../api/ediscovery-custodian-list-sitesources.md)|[microsoft.graph.ediscovery.siteSource](../resources/ediscovery-sitesource.md) collection|Get the **siteSource** resources associated with the custodian.|

+|[Create site sources](../api/ediscovery-custodian-post-sitesources.md)|[microsoft.graph.ediscovery.siteSource](../resources/ediscovery-sitesource.md)|Create a new **siteSource** object.|

+|[List unified group sources](../api/ediscovery-custodian-list-unifiedgroupsources.md)|[microsoft.graph.ediscovery.unifiedGroupSource](../resources/ediscovery-unifiedgroupsource.md) collection|Get the list of **unifiedGroupSource** resources associated with the custodian.|

+|[Create unified group sources](../api/ediscovery-custodian-post-unifiedgroupsources.md)|[microsoft.graph.ediscovery.unifiedGroupSource](../resources/ediscovery-unifiedgroupsource.md)|Create a new **unifiedGroupSource** object.|

+|[List user sources](../api/ediscovery-custodian-list-usersources.md)|[microsoft.graph.ediscovery.userSource](../resources/ediscovery-usersource.md) collection|Get the list of **userSource** resources associated with the custodian.|

+|[Create user sources](../api/ediscovery-custodian-post-usersources.md)|[microsoft.graph.ediscovery.userSource](../resources/ediscovery-usersource.md)|Create a new **userSource** object.|

+|[List site sources](../api/ediscovery-legalhold-list-sitesources.md)|[microsoft.graph.ediscovery.siteSource](../resources/ediscovery-sitesource.md) collection|Get the list of [siteSource](../resources/ediscovery-sitesource.md) objects associated with a legal hold.|

+|[Create site source](../api/ediscovery-legalhold-post-sitesources.md)|[microsoft.graph.ediscovery.siteSource](../resources/ediscovery-sitesource.md)|Create a new siteSource object.|

+|[List user sources](../api/ediscovery-legalhold-list-usersources.md)|[microsoft.graph.ediscovery.userSource](../resources/ediscovery-usersource.md) collection|Get the list of [userSource](../resources/ediscovery-usersource.md) objects associated with a legal hold.|

+|[Create user source](../api/ediscovery-legalhold-post-usersources.md)|[microsoft.graph.ediscovery.userSource](../resources/ediscovery-usersource.md)|Create a new **userSource** object.|

+|[Add noncustodial source](../api/ediscovery-sourcecollection-post-noncustodialsources.md)|[microsoft.graph.ediscovery.noncustodialSource](../resources/ediscovery-noncustodialdatasource.md) collection|Add a noncustodial source **noncustodialSource** object to the source collection.|

+|[List noncustodial sources](../api/ediscovery-sourcecollection-list-noncustodialsources.md)|[microsoft.graph.ediscovery.noncustodialSource](../resources/ediscovery-noncustodialdatasource.md) collection|Get a list of noncustodial sources **noncustodialSource** objects associated with a source collection.|

+|allCaseNoncustodialDataSources|Include all noncustodial data sources in the **sourceCollection**.|

+|[List](../api/educationassignmentsettings-get.md)|[educationGradingScheme](../resources/educationgradingscheme.md) collection|Get a list of the [educationGradingScheme](../resources/educationgradingscheme.md) objects and their properties.|

+|[Create](../api/educationassignment-post-gradingscheme.md)|[educationGradingScheme](../resources/educationgradingscheme.md)|Create a new [educationGradingScheme](../resources/educationgradingscheme.md) object.|

+|[Get](../api/educationgradingscheme-get.md)|[educationGradingScheme](../resources/educationgradingscheme.md)|Read the properties and relationships of an [educationGradingScheme](../resources/educationgradingscheme.md) object.|

+|[Update](../api/educationgradingscheme-update.md)|[educationGradingScheme](../resources/educationgradingscheme.md)|Update the properties of an [educationGradingScheme](../resources/educationgradingscheme.md) object.|

+|[Delete](../api/educationgradingscheme-delete.md)|None|Delete an [educationGradingScheme](../resources/educationgradingscheme.md) object.|

+|[Create class](../api/educationroot-post-classes.md) |[educationClass](educationclass.md)| Create a new **educationClass** by posting to the classes collection.|

+|[Create school](../api/educationroot-post-schools.md) |[educationSchool](educationschool.md)| Create a new **educationSchool** by posting to the schools collection.|

+|[Create user](../api/educationroot-post-users.md) |[educationUser](educationuser.md)| Create a new **educationUser** by posting to the users collection.|

+| [Get administrative unit](../api/educationschool-get-administrativeunit.md) | [administrativeUnit](administrativeunit.md) | Get the **administrativeUnit** that corresponds to this **educationSchool**. |

+### virtualEventRegistrationPredefinedQuestionLabel values

+| Member |

+|:-|

+| street |

+| city |

+| state |

+| postalCode |

+| countryOrRegion |

+| industry |

+| jobTitle |

+| organization |

+| unknownFutureValue |

+|[Delete recycle bin items](../api/filestoragecontainer-delete-recyclebin-items.md)|None|Delete recycle bin items from a fileStorageContainer.|

+|[Get order](../api/identityuserflowattributeassignment-getorder.md)|[assignmentOrder](../resources/assignmentorder.md)|Gets the order of the identityUserFlowAttributes being collected within a user flow.|

+|[Set order](../api/identityuserflowattributeassignment-setorder.md)|None|Sets the order of the identityUserFlowAttributes being collected within a user flow.|

+|[Get](../api/linkedresource_v2-get.md)|[linkedResource_v2](../resources/linkedresource_v2.md)|Read the properties and relationships of a [linkedResource_v2](../resources/linkedresource_v2.md) object.|

+|[Update](../api/linkedresource_v2-update.md)|[linkedResource_v2](../resources/linkedresource_v2.md)|Update the properties of a [linkedResource_v2](../resources/linkedresource_v2.md) object.|

+|[Delete](../api/linkedresource_v2-delete.md)|None|Deletes a [linkedResource_v2](../resources/linkedresource_v2.md) object.|

+| [Create](../api/list-create.md) | [list](../resources/list.md) | Create a new **list** in a **site**. |

+| [Get](../api/list-get.md) | [list](../resources/list.md) | Get the metadata for a **list**. |

+| [Get items](../api/listitem-list.md) | [listItem](../resources/listitem.md) collection | Get the collection of [listItems]( ../resources/listitem.md) in a **list**. |

+| [Create item](../api/listitem-create.md) | [listItem](../resources/listitem.md) | Create a new [listItem]( ../resources/listitem.md) in a **list**. |

+| [List permissions](../api/list-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [list](../resources/list.md).|

+| [Create permission](../api/list-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [list](../resources/list.md).|

+| [Get permission](../api/list-post-permissions.md)| [permission](../resources/permission.md) |Create a new [permission](../resources/permission.md) object on a [list](../resources/list.md).|

+| [Update permission](../api/list-update-permissions.md)| [permission](../resources/permission.md) |Update a [permission](../resources/permission.md) object on a [list](../resources/list.md).|

+| [Delete permission](../api/list-delete-permissions.md)| None |Delete a [permission](../resources/permission.md) object on a [list](../resources/list.md).|

+| permissions | [permission](permission.md) collection | The set of permissions for the item. Read-only. Nullable. |

+All examples are relative to a **[list][]**; for example, `https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}`.

+| Method | Return Type | Description |

+|:-|:--|:--|

+| [Create][] | listItem | Create a new listItem in a list. |

+| [Get][] | listItem | Get an item in a list. |

+| [Update][] | [fieldValueSet][] | Update the properties on a listItem. |

+| [Delete][] | No Content | Removes an item from a list. |

+| [Get analytics][] | [itemAnalytics][] | Get analytics for this resource. |

+| [Get column values][Get] | listItem | Get column values from listItem. |

+| [Update column values][Update] | [fieldValueSet][] | Update column values on a listItem. |

+| [List document set version](../api/listitem-list-documentsetversions.md) | [documentSetVersion][] collection | Get a list of the versions of a document set item in a list. |

+| [Create document set version](../api/listitem-post-documentsetversions.md) | [documentSetVersion][] | Create a new version of a document set item in a list. |

+| [Restore document set version](../api/documentsetversion-restore.md) | No Content | Restore the document set item to a specific version. |

+| [Get delta](../api/listitem-delta.md) | [listItem](../resources/listitem.md) collection | Get newly created, updated, or deleted [list items](../resources/listitem.md) without having to perform a full read of the entire items collection. |

+| [List permissions](../api/listitem-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [listItem](../resources/listitem.md).|

+| [Create permission](../api/listitem-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [listItem](../resources/listitem.md).|

+| [Get permission](../api/listitem-post-permissions.md)| [permission](../resources/permission.md) |Create a new [permission](../resources/permission.md) object on a [listItem](../resources/listitem.md).|

+| [Update permission](../api/listitem-update-permissions.md)| [permission](../resources/permission.md) |Update a [permission](../resources/permission.md) object on a [listItem](../resources/listitem.md).|

+| [Delete permission](../api/listitem-delete-permissions.md)| None |Delete a [permission](../resources/permission.md) object on a [listItem](../resources/listitem.md).|

+[itemActivityStat]: itemactivitystat.md

+[fieldValueSet]: fieldvalueset.md

+[documentSetVersion]: documentsetversion.md

+| permissions | [permission](permission.md) collection | The set of permissions for the item. Read-only. Nullable. |

+|[Get](../api/networkaccess-forwardingpolicylink-get.md)|[microsoft.graph.networkaccess.forwardingPolicyLink](../resources/networkaccess-forwardingpolicylink.md)|Read the properties and relationships of a [microsoft.graph.networkaccess.forwardingPolicyLink](../resources/networkaccess-forwardingpolicylink.md) object.|

+| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |

+| alternativeRecording (deprecated) | Stream | The content stream of the alternative recording of a [Microsoft Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. |

+| attendeeReport (deprecated) | Stream | The content stream of the attendee report of a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. |

+| broadcastSettings (deprecated) | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event. |

+| isBroadcast (deprecated) | Boolean | Indicates whether this event is a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). |

+| recording (deprecated) | Stream | The content stream of the recording of a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. |

+>- The **autoAdmittedUsers** property is deprecated. Use the **scope** property of [lobbyBypassSettings](lobbybypasssettings.md) instead.

+| [Get transitive reports](../api/orgcontact-get-transitivereports.md) | Integer | Get the count of transitive reports for an organization contact from the transitiveReports navigation property. |

+|[List task folders](../api/outlooktaskgroup-list-taskfolders.md) |[outlookTaskFolder](outlooktaskfolder.md) collection| Get a collection of Outlook task folders.|

+|[Create task folder](../api/outlooktaskgroup-post-taskfolders.md) |[outlookTaskFolder](outlooktaskfolder.md)| Create an Outlook task folder.|

+| [List role schedules](../api/rbacapplication-roleschedules.md) | [unifiedRoleScheduleBase](unifiedroleschedulebase.md) collection | Function to retrieve a collection of unifiedRoleScheduleBase objects. |

+| [List role schedule instances](../api/rbacapplication-rolescheduleinstances.md) | [unifiedRoleScheduleInstanceBase](unifiedrolescheduleinstancebase.md) collection | Function to retrieve a collection of unifiedRoleScheduleInstanceBase objects. |

+|[List](../api/sectiongroup-list-sectiongroups.md) |[sectionGroup](sectiongroup.md) collection| Get collection of section groups in the specified section group.|

+|[Get](../api/sectiongroup-get.md) | [sectionGroup](sectiongroup.md) |Read the properties and relationships of the section group.|

+|[Create](../api/sectiongroup-post-sectiongroups.md) |[sectionGroup](sectiongroup.md)| Create a section group by posting to the sectionGroups collection in the specified section group.|

+|[Create section](../api/sectiongroup-post-sections.md) |[onenoteSection](onenotesection.md)| Create a section by posting to the sections collection in the specified section group.|

+|[List](../api/security-list-alerts_v2.md)|[microsoft.graph.security.alert](security-alert.md) collection|Get a list of [alert](../resources/security-alert.md) resources that track suspicious activities in an organization.|

+|[Get](../api/security-alert-get.md)|[microsoft.graph.security.alert](security-alert.md)|Get the properties of an [alert](../resources/security-alert.md) object in an organization based on the specified alert **ID** property.|

+|[Update](../api/security-alert-update.md)|[microsoft.graph.security.alert](../resources/security-alert.md)|Update the properties of an [alert](../resources/security-alert.md) object in an organization based on the specified alert **ID** property.|

+|[Create comment](../api/security-alert-post-comments.md)| [alertComment](../resources/security-alertcomment.md) | Create a comment for an existing [alert](../resources/security-alert.md) based on the specified alert **ID** property.|

+ Title: shared resource type

+description: Indicates that a drive item has been shared with others.

+# shared resource type

+Indicates that a [drive item](driveitem.md) was shared with others and includes information about how the item is shared.

+If a [driveItem](driveitem.md) has a non-null **shared** facet, the item was shared.

+## Properties

+| Property | Type | Description

+| :- |:|:-

+| owner | [IdentitySet](identityset.md) | The identity of the owner of the shared item. Read-only.|

+| sharedBy | [identitySet](identityset.md) | The identity of the user who shared the item. Read-only.|

+| sharedDateTime | DateTimeOffset | The UTC date and time when the item was shared. Read-only.|

+| scope (deprecated)| String | Indicates the scope of how the item is shared. The possible values are: `anonymous`, `organization`, or `users`. Read-only.|

+### scope property values

+| Value | Description |

+|:|:--|

+| `anonymous` | The item is shared by using a link that works for anyone with the link. |

+| `organization` | The item is shared by using a link that works for anyone in the owner's organization. |

+| `users` | The item is shared with specific users only. |

+|[Get associated bot](../api/teamworkbot-get.md) | [teamworkbot](teamworkbot.md) | Get the bot associated with the Teams app.|

+|attemptsCount|Int32|Number of times the operation was attempted before being marked successful or failed.|

+|error|[operationError](operationerror.md)|Any error that causes the async operation to fail.|

+|id|string |Unique operation ID.|

+|operationType|[teamsAsyncOperationType](teamsasyncoperationtype.md) |Denotes the type of operation described. Possible values are: `invalid`, `cloneTeam`, `archiveTeam`, `unarchiveTeam`, `createTeam`, `unknownFutureValue`, `teamifyGroup`, `createChannel`, `createChat`, `archiveChannel`, `unarchiveChannel`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `teamifyGroup`, `createChannel`, `createChat`, `archiveChannel`, `unarchiveChannel`.|

+|status|[teamsAsyncOperationStatus](teamsasyncoperationstatus.md)| Operation status.|

+|targetResourceId|String |The ID of the object that's created or modified as result of this async operation, typically a [team](../resources/team.md).|

+The following JSON representation shows the resource type.

+ "attemptsCount": "Int32",

+ "createdDateTime": "String (timestamp)",

+ "error": { "@odata.type": "microsoft.graph.operationError" },

+ "id": "String (identifier)",

+ "lastActionDateTime": "String (timestamp)",

+ "operationType": "String",

+ "status": "String",

+ "targetResourceId": "String",

+ "targetResourceLocation": "String"

+|[Upload X.509 certificate](../api/trustframeworkkeyset-uploadcertificate.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Upload a X.509 certificate.|

+|[Upload PKCS12 certificate](../api/trustframeworkkeyset-uploadpkcs12.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Upload a PKCS12 format certificate.|

+description: "Represents a registrant's registration record of a virtual event."

+Represents a registrant's registration record for a [virtualEvent](../resources/virtualevent.md).

+Currently, only [virtualEventWebinar](../resources/virtualeventwebinar.md) is supported.

+|[Create](../api/virtualeventregistration-post.md)|None|Create a registrant's [registration record](../resources/virtualeventregistration.md) for a [webinar](../resources/virtualeventwebinar.md).|

+|[Cancel](../api/virtualeventregistration-cancel.md)|None|Cancel a registrant's [registration record](../resources/virtualeventregistration.md) for a [webinar](../resources/virtualeventwebinar.md).|

+|[List sessions](../api/virtualeventregistration-list-sessions.md)|[virtualEventSession](../resources/virtualeventsession.md) collection|Get a list of [sessions](../resources/virtualeventsession.md) that a registrant registered for in a [webinar](../resources/virtualeventwebinar.md).|

+|preferredTimezone|String|The registrant's time zone details.|

+|preferredLanguage|String|The registrant's preferred language.|

+ "userId": "String",

+ "preferredTimezone": "String",

+ "preferredLanguage": "String"

+|questions|[virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md) collection|Registration questions.|

+ Title: "virtualEventRegistrationCustomQuestion resource type"

+description: "Information about a custom virtual event registration question."

+ms.localizationpriority: medium

+# virtualEventRegistrationCustomQuestion resource type

+Namespace: microsoft.graph

+Represents a custom registration question associated with a [virtualEventRegistration](../resources/virtualeventregistration.md).

+Inherits from [virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|answerChoices|String collection|Answer choices when **answerInputType** is `singleChoice` or `multiChoice`. |

+|answerInputType|[virtualEventRegistrationQuestionAnswerInputType](#virtualeventregistrationquestionanswerinputtype-values)|Input type of the registration question answer.|

+|displayName|String|Display name of the registration question. Inherited from [virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md).|

+|id|String|Unique identifier of the registration question. Inherited from [virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md).|

+|isRequired|Boolean| Indicates whether an answer to the question is required. The default value is `false`. Inherited from [virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md).|

+### virtualEventRegistrationQuestionAnswerInputType values

+The following shows the supported types of answer input for a custom registration question.

+| Member | Description |

+| -- | -- |

+| text | The registration question accepts single-line text. |

+| multilineText | The registration question accepts multi-line text. |

+| singleChoice | The registration question accepts one answer from a list of options. |

+| multiChoice | The registration question accepts more than one answer from a list of options. |

+| boolean | The registration question accepts a yes, or no answer. |

+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |

+## JSON representation

+The following JSON representation shows the resource type.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.virtualEventRegistrationCustomQuestion",

+ "baseType": "microsoft.graph.virtualEventRegistrationQuestionBase",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",

+ "answerChoices": [

+ "String"

+ ],

+ "answerInputType": "String",

+ "displayName": "String",

+ "id": "String (identifier)",

+ "isRequired": "Boolean"

+}

+```

+ Title: "virtualEventRegistrationPredefinedQuestion resource type"

+description: "Represents a predefined registration question associated with a virtual event."

+ms.localizationpriority: medium

+# virtualEventRegistrationPredefinedQuestion resource type

+Namespace: microsoft.graph

+Represents a predefined registration question associated with a [virtualEventRegistration](../resources/virtualeventregistration.md).

+Currently, [virtualEventRegistration](../resources/virtualeventregistration.md) only supports [virtualEventWebinar](../resources/virtualeventwebinar.md).

+Inherits from [virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|displayName|String|Display name of the registration question. Inherited from [virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md).|

+|id|String|Unique identifier of the registration question. Inherited from [virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md).|

+|isRequired|Boolean| Indicates whether an answer to the question is required. The default value is `false`. Inherited from [virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md).|

+|label|virtualEventRegistrationPredefinedQuestionLabel|Label of the predefined registration question. The following label values accept a single line of text: `street`, `city`, `state`, `postalCode`, `countryOrRegion`, `industry`, `jobTitle`, and `organization`. `unknownFutureValue` is an evolvable enumeration sentinel value; do not use this label.|

+## JSON representation

+The following JSON representation shows the resource type.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.virtualEventRegistrationPredefinedQuestion",

+ "baseType": "microsoft.graph.virtualEventRegistrationQuestionBase",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.virtualEventRegistrationPredefinedQuestion",

+ "label": "String",

+ "displayName": "String",

+ "id": "String (identifier)",

+ "isRequired": "Boolean"

+}

+```

+description: "Represents an answer or answers to a registration question of a virtual event."

+Represents an answer or answers to either a [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) or a [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md).

+|booleanValue|Boolean|Boolean answer to the [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md). Only appears when **answerInputType** is `boolean`. |

+|multiChoiceValues|String collection|A collection of text answers to the [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md). Only appears when **answerInputType** is `multiChoice`.|

+|questionId|String|The identifier of either a [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) or a [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md).|

+|value|String|Text answer to the [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) or the [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md). Appears when **answerInputType** is `text`, `multilineText` or `singleChoice`.|

+ Title: "virtualEventRegistrationQuestionBase resource type"

+description: "The abstract base type for a virtual event registration question."

+ms.localizationpriority: medium

+toc. Title: Virtual event registration question

+# virtualEventRegistrationQuestionBase resource type

+Namespace: microsoft.graph

+The abstract base type for a virtual event registration question.

+Base type of [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) and [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md).

+Inherits from [entity](../resources/entity.md).

+> [!TIP]

+> This is an abstract type and can't be used directly. Use the derived types [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) and [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md) instead.

+## Methods

+|Method|Return type|Description|

+|:|:|:|

+|[List](../api/virtualeventregistrationconfiguration-list-questions.md)|[virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) collection or [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md) collection|Get a list of all [registration](../resources/virtualeventregistration.md) questions for a [webinar](../resources/virtualeventwebinar.md).|

+|[Create](../api/virtualeventregistrationconfiguration-post-questions.md)|[virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) object or [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md) object|Create a [registration](../resources/virtualeventregistration.md) question for a [webinar](../resources/virtualeventwebinar.md).|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|displayName|String|Display name of the registration question.|

+|id|String|Unique identifier of the registration question. Inherited from [entity](../resources/entity.md).|

+|isRequired|Boolean| Indicates whether an answer to the question is required. The default value is `false`.|

+## JSON representation

+The following JSON representation shows the resource type.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.virtualEventRegistrationQuestionBase",

+ "baseType": "microsoft.graph.entity",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.virtualEventRegistrationQuestionBase",

+ "displayName": "String",

+ "id": "String (identifier)",

+ "isRequired": "Boolean"

+}

+```

+| [Publish](../api/virtualeventwebinar-publish.md) | None | Publish a [virtualEventWebinar](../resources/virtualeventwebinar.md). |

+| [Cancel](../api/virtualeventwebinar-cancel.md) | None | Cancel a [virtualEventWebinar](../resources/virtualeventwebinar.md). |

+## Relationships

+|Relationship|Type|Description|

+|:|:|:|

+| questions | [virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md) collection | Registration questions. |

+|[Delete operational insights connection](../api/windowsupdates-operationalinsightsconnection-delete.md)|None|Delete an [operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md) object.|

+|[List](../api/chart-list.md) | [workbookChart](workbookchart.md) collection |Get chart object collection. |

+|[Get](../api/chart-get.md) | [workbookChart](workbookchart.md) |Read properties and relationships of chart object.|

+|[Update](../api/chart-update.md) | [workbookChart](workbookchart.md) |Update Chart object. |

+|[Delete](../api/chart-delete.md)|None|Deletes the chart object.|

+|[Add](../api/chartcollection-add.md)|[workbookChart](workbookchart.md)|Creates a new chart.|

+|[Create series](../api/chart-post-series.md) |[workbookChartSeries](workbookchartseries.md)| Create a new chartSeries by posting to the series collection.|

+|[List series](../api/chart-list-series.md) |[workbookChartSeries](workbookchartseries.md) collection| Get a chartSeries object collection.|

+|[Get chart at position](../api/chartcollection-itemat.md)|[workbookChart](workbookchart.md)|Gets a chart based on its position in the collection.|

+|[List](../api/nameditem-list.md) | [workbookNamedItem](workbooknameditem.md) collection |Get a collection of **namedItem** objects. |

+|[Add](../api/nameditem-add.md)|[workbookNamedItem](workbooknameditem.md)|Add a new name to the collection of the given scope.|

+|[Add name to collection](../api/nameditem-addformulalocal.md)|[workbookNamedItem](workbooknameditem.md)|Add a new name to the collection of the given scope using the user's locale for the formula.|

+|[List range](../api/nameditem-range.md)|[workbookRange](workbookrange.md)|Return the range object that is associated with the name. Throw an exception if the named item's type is not a range.|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+Update the properties of an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object.

+The properties can be for one of the following derived types:

+* [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md)

+* [x509certificatecombinationconfiguration](../resources/x509certificatecombinationconfiguration.md)

+|appliesToCombinations|authenticationMethodModes collection|The combinations where this configuration applies. For **fido2combinationConfigurations** use `"fido2"`, for **x509certificatecombinationconfiguration** use `"x509CertificateSingleFactor"` or `"x509CertificateMultiFactor"`. Required.|

+Get the [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) objects for an [authentication strength policy](../resources/authenticationstrengthpolicy.md). The objects can be of one or more of the following derived types:

+* [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md)

+* [x509certificatecombinationconfiguration](../resources/x509certificatecombinationconfiguration.md)

+**authenticationCombinationConfiguration** objects are supported only for custom authentication strengths.

+description: "Create a new authenticationCombinationConfiguration object."

+# Create authenticationCombinationConfiguration

+Create a new authenticationCombinationConfiguration object which can be of one of the following derived types:

+* [fido2combinationConfiguration](../resources/fido2combinationconfiguration.md)

+* [x509certificatecombinationconfiguration](../resources/x509certificatecombinationconfiguration.md)

+|appliesToCombinations|authenticationMethodModes collection|The combinations where this configuration applies. For **fido2combinationConfigurations** use `"fido2"`, for **x509certificatecombinationconfiguration** use `"x509CertificateSingleFactor"` or `"x509CertificateMultiFactor"`. Required.|

+If successful, this method returns a `201 Created` response code and an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object which can be a [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) or an [x509certificatecombinationconfiguration](../resources/x509certificatecombinationconfiguration.md) object in the response body.

+### Example 1: Create a fido2combinationConfiguration object

+#### Request

+ "name": "create_authenticationcombinationconfiguration_fido2CombinationConfiguration"

+POST https://graph.microsoft.com/v1.0/identity/conditionalAccess/authenticationStrength/policies/{authenticationStrengthPolicyId}//combinationConfigurations

+#### Response

+### Example 2: Create a x509CertificateCombinationConfiguration object

+#### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "create_authenticationcombinationconfiguration_x509CertificateCombinationConfiguration"

+}

+-->

+``` http

+POST https://graph.microsoft.com/v1.0/identity/conditionalAccess/authenticationStrength/policies/{authenticationStrengthPolicyId}/combinationConfigurations

+

+{

+ "@odata.type": "#microsoft.graph.x509CertificateCombinationConfiguration",

+ "allowedIssuerSkis": [

+ "9A4248C6AC8C2931AB2A86537818E92E7B6C97B6"

+ ],

+ "allowedPolicyOIDs": [],

+ "appliesToCombinations": [

+ "x509CertificateSingleFactor "

+ ]

+}

+```

+#### Response

+The following example shows the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.authenticationCombinationConfiguration"

+}

+-->

+``` http

+HTTP/1.1 201 Created

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.x509CertificateCombinationConfiguration",

+ "id" : "96cb1a17-e45e-4b4f-8b4b-4a9490d63d66",

+ "allowedIssuerSkis": [

+ "9A4248C6AC8C2931AB2A86537818E92E7B6C97B6"

+ ],

+ "allowedPolicyOIDs": [],

+ "appliesToCombinations": [

+ "x509CertificateSingleFactor "

+ ]

+}

+```

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+ Title: "channel: archive"

+description: "Archive a channel in a team."

+ms.localizationpriority: medium

+# channel: archive

+Namespace: microsoft.graph

+Archive a [channel](../resources/channel.md) in a team. When a channel is archived, users can't send new messages or react to existing messages in the channel, edit the channel settings, or make other changes to the channel.

+You can delete an archived channel or add and remove members from it. If you archive a team, its channels are also archived.

+Archiving is an asynchronous operation; a channel is archived after the asynchronous archiving operation completes successfully, which might occur after the response returns.

+A channel without an owner or that belongs to a [group](../resources/group.md) that has no owner, can't be archived.

+To restore a channel from its archived state, use the [channel: unarchive](channel-unarchive.md) method. A channel canΓÇÖt be archived or unarchived if its team is archived.

+## 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) | ChannelSettings.ReadWrite.All |

+|Delegated (personal Microsoft account) | Not supported. |

+|Application | ChannelSettings.ReadWrite.All |

+> **Note**: This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't members of.

+## HTTP request

+<!-- { "blockType": "ignored" } -->

+```http

+POST /teams/{team-id}/channels/{channel-id}/archive

+POST /groups/{team-id}/team/channels/{channel-id}/archive

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Content-Type | application/json. Optional. |

+## Request body

+In the request body, you can optionally provide a JSON object with the following parameter.

+| Parameter | Type |Description|

+|:|:--|:-|

+|shouldSetSpoSiteReadOnlyForMembers|Boolean|Defines whether to set permissions for channel members to read-only on the SharePoint Online site associated with the team. If you set it to `false` or omit the parameter, this step is skipped.|

+The following example shows the request body with **shouldSetSpoSiteReadOnlyForMembers** set to `true`.

+```json

+{

+ "shouldSetSpoSiteReadOnlyForMembers": true

+}

+```

+## Response

+If archiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header that specifies the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle the archiving of the channel in a team. Check the status of the archiving operation by making a GET request to this location.

+## Examples

+### Example 1: Archive a channel

+The following example shows a request to archive a channel.

+#### Request

+<!-- {

+ "blockType": "request",

+ "name": "archive_channel",

+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]

+}-->

+```http

+POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/archive

+```

+#### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "name": "archive_channel"

+}-->

+```http

+HTTP/1.1 202 Accepted

+Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba

+Content-Type: text/plain

+Content-Length: 0

+```

+### Example 2: Archive a channel when the team is archived

+The following example shows a request to archive a channel that fails because the team is archived; the team must be active to archive or unarchive a channel.

+#### Request

+<!-- {

+ "blockType": "request",

+ "name": "archive_channel_on_archived_team",

+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]

+}-->

+```http

+POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/archive

+```

+#### Response

+The following example shows the `400 Bad Request` response code with a corresponding error message.

+<!-- {

+ "blockType": "response",

+ "name": "archive_channel_on_archived_team",

+ "@odata.type": "microsoft.graph.publicError",

+ "truncated": true

+}-->

+```http

+http/1.1 400 Bad Request

+Content-Type: application/json

+Content-Length: 193

+{

+ "error": {

+ "code": "BadRequest",

+ "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",

+ "innerError": {

+ "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",

+ "code": "Unknown",

+ "innerError": {},

+ "date": "2023-12-11T04:26:35",

+ "request-id": "8f897345980-f6f3-49dd-83a8-a3064eeecdf8",

+ "client-request-id": "50a0er33-4567-3f6c-01bf-04d144fc8bbe"

+ }

+ }

+}

+```

+ "membershipType": "standard",

+ "isArchived": false

+ "membershipType": "standard",

+ "isArchived": false

+ "membershipType": "private",

+ "isArchived": false

+ "moderationSettings": null,

+ "isArchived": false

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+ Title: "channel: unarchive"

+description: "Restore an archived channel in a team."

+ms.localizationpriority: medium

+# channel: unarchive

+Namespace: microsoft.graph

+Restore an archived [channel](../resources/channel.md). Unarchiving restores the ability for users to send messages and edit the channel. Channels are archived via the [channel: archive](channel-archive.md) method.

+Unarchiving is an asynchronous operation; a channel is unarchived when the asynchronous unarchiving operation completes successfully, which might occur after this method responds.

+> **Note**: An archived channel that belongs to an archived team can't be unarchived. Unarchive the team before you unarchive the channel; otherwise, the request fails.

+## 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) | ChannelSettings.ReadWrite.All |

+|Delegated (personal Microsoft account) | Not supported. |

+|Application | ChannelSettings.ReadWrite.All |

+> **Note**: This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't a member of.

+## HTTP request

+<!-- { "blockType": "ignored" } -->

+```http

+POST /teams/{team-id}/channels/{channel-id}/unarchive

+POST /groups/{team-id}/team/channels/{channel-id}/unarchive

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+## Request body

+Don't supply a request body for this method.

+## Response

+If unarchiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header that specifies the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle the unarchiving of the channel in a team. Check the status of the unarchiving operation by making a GET request to this location.

+## Examples

+### Example 1: Unarchive a channel

+The following example shows a request to unarchive a channel.

+#### Request

+<!-- {

+ "blockType": "request",

+ "name": "unarchive_channel",

+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]

+}-->

+```http

+POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/unarchive

+```

+#### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "name": "unarchive_channel"

+}-->

+```http

+HTTP/1.1 202 Accepted

+Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba

+Content-Type: text/plain

+Content-Length: 0

+```

+### Example 2: Unarchive a channel when the team is archived

+The following example shows a request to unarchive a channel that fails because the team is archived; the team must be active to archive or unarchive a channel.

+#### Request

+<!-- {

+ "blockType": "request",

+ "name": "unarchive_channel_on_archived_team",

+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]

+}-->

+```http

+POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/unarchive

+```

+#### Response

+The following example shows the `400 Bad Request` response code with a corresponding error message.

+<!-- {

+ "blockType": "response",

+ "name": "unarchive_channel_on_archived_team",

+ "@odata.type": "microsoft.graph.publicError",

+ "truncated": true

+}-->

+```http

+http/1.1 400 Bad Request

+Content-Type: application/json

+Content-Length: 193

+{

+ "error": {

+ "code": "BadRequest",

+ "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",

+ "innerError": {

+ "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",

+ "code": "Unknown",

+ "innerError": {},

+ "date": "2023-12-11T04:26:35",

+ "request-id": "8f897345980-f6f3-49dd-83a8-a3064eeecdf8",

+ "client-request-id": "50a0er33-4567-3f6c-01bf-04d144fc8bbe"

+ }

+ }

+}

+```

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+> [!NOTE]

+> Sometimes it takes time to reflect the addition of a member after they are added. Users can use [change notifications](../resources/change-notifications-api-overview.md) to subscribe to notifications for membership changes in a particular team.

+The following example shows the response.

+ },

+ "tenantRestrictions": {

+ "usersAndGroups": {

+ "accessType": "blocked",

+ "targets": [

+ {

+ "target": "AllUsers",

+ "targetType": "user"

+ }

+ ]

+ },

+ "applications": {

+ "accessType": "blocked",

+ "targets": [

+ {

+ "target": "AllApplications",

+ "targetType": "application"

+ }

+ ]

+ }

+ "isHybridAzureADJoinedDeviceAccepted": false

+ "tenantRestrictions": {

+ "usersAndGroups": {

+ "accessType": "blocked",

+ "targets": [

+ {

+ "target": "AllUsers",

+ "targetType": "user"

+ }

+ ]

+ },

+ "applications": {

+ "accessType": "blocked",

+ "targets": [

+ {

+ "target": "AllApplications",

+ "targetType": "application"

+ }

+ ]

+ }

+ },

+| tenantRestrictions |[crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the default tenant restrictions configuration for users in your organization who access an external organization on your network or devices. |

+ },

+ "tenantRestrictions": {

+ "usersAndGroups": {

+ "accessType": "blocked",

+ "targets": [

+ {

+ "target": "AllUsers",

+ "targetType": "user"

+ }

+ ]

+ },

+ "applications": {

+ "accessType": "blocked",

+ "targets": [

+ {

+ "target": "AllApplications",

+ "targetType": "application"

+ }

+ ]

+ }

+| tenantRestrictions |[crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the default tenant restrictions configuration for users in your organization who access an external organization on your network or devices. |

+### Example 3: Configure tenant restrictions settings

+The following example shows how to configure tenant restrictions settings.

+#### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "update_crosstenantaccesspolicyconfigurationpartner_tenantrestriction"

+}

+-->

+``` http

+PATCH https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners/90e29127-71ad-49c7-9ce8-db3f41ea06f1

+Content-Type: application/json

+{

+ "tenantRestrictions": {

+ "usersAndGroups": {

+ "accessType": "allowed",

+ "targets": [

+ {

+ "target": "AllUsers",

+ "targetType": "user"

+ }

+ ]

+ },

+ "applications": {

+ "accessType": "allowed",

+ "targets": [

+ {

+ "target": "Office365",

+ "targetType": "application"

+ }

+ ]

+ }

+ }

+}

+```

+#### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+### Example 2: Create Apple identity provider (only for Azure AD B2C)

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|

+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|