+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+| 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 the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+<!-- { "blockType": "ignored", "name": "callrecording_get" } -->

+|Permission type|Least privileged permissions|Higher privileged permissions|

+|:|:|:|

+|Delegated (work or school account)|OnlineMeetingRecording.Read.All|Not available.|

+|Delegated (personal Microsoft account)|Not supported.|Not supported.|

+|Application|OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read.Chat|Not available|

+<!-- { "blockType": "ignored", "name": "calltranscript_get" } -->

+| Permission type| Least privileged permissions|Higher privileged permissions|

+| :| :| : |

+|Delegated (work or school account)| OnlineMeetingTranscript.Read.All| Not available.|

+|Delegated (personal Microsoft account)|Not supported.|Not supported.|

+|Application|OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat|Not available.|

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

+# [HTTP](#tab/http)

+<!-- {

+ "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

+# [C#](#tab/csharp)

+# [CLI](#tab/cli)

+# [Go](#tab/go)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [PHP](#tab/php)

+# [PowerShell](#tab/powershell)

+# [Python](#tab/python)

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

+}-->

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

+# [HTTP](#tab/http)

+<!-- {

+ "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

+# [C#](#tab/csharp)

+# [CLI](#tab/cli)

+# [Go](#tab/go)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [PHP](#tab/php)

+# [PowerShell](#tab/powershell)

+# [Python](#tab/python)

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+|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",

+ Title: "cloudPC: retrieveCloudPcRemoteActionResults"

+description: "Retrieve remote action results and check the status of a specific remote action performed on the associated Cloud PC device."

+ms.localizationpriority: medium

+# cloudPC: retrieveCloudPcRemoteActionResults

+Namespace: microsoft.graph

+Retrieve [remote action results](../resources/cloudpcremoteactionresult.md) and check the status of a specific remote action performed on the associated Cloud PC device.

+## 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": "cloudpc-retrievecloudpcremoteactionresults" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /deviceManagement/virtualEndpoint/cloudPCs/{id}/retrieveCloudPcRemoteActionResults

+```

+## 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 [cloudPcRemoteActionResult](../resources/cloudpcremoteactionresult.md) objects in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "cloudpc_retrievecloudpcremoteactionresults"

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/46ed3acc-70f8-4978-a5ba-62945ecc5e4c/retrieveCloudPcRemoteActionResults

+```

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

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.cloudPcRemoteActionResult)",

+ "value": [

+ {

+ "actionName": "CloudPcPowerOn",

+ "actionState": "done",

+ "startDateTime": "2024-05-28T06:12:47.4100777Z",

+ "lastUpdatedDateTime": "2024-05-28T06:13:45.2270925Z",

+ "cloudPcId": "46ed3acc-70f8-4978-a5ba-62945ecc5e4c",

+ "managedDeviceId": null,

+ "statusDetail": null,

+ "statusDetails": null

+ }

+ ]

+}

+```

+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/bulkActions/0d76d02b-e0a0-4f58-baff-d1718cc2d144

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

+ "displayName": "BulkPowerOn on 2024-6-14 17:05:43 GMT-0300 (French Guiana Time)",

+ "id": "0d76d02b-e0a0-4f58-baff-d1718cc2d144",

+ "a38fdc98-0861-4de6-9892-0c793dad36d4"

+ "scheduledDuringMaintenanceWindow": false,

+ "createdDateTime": "2024-06-14T20:05:44.5239567Z",

+ "status": "succeeded",

+ "initiatedByUserPrincipalName": "johnd@contoso.com",

+ "failedCount": 0,

+ "inProgressCount": 0,

+ "notSupportedCount": 0,

+ "pendingCount": 0,

+ "successfulCount": 1

+ }

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

+|reportName|cloudPcReportName|The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`. 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): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`.|

+ Title: "cloudPcReports: retrieveCrossRegionDisasterRecoveryReport"

+description: "Retrieve the Windows 365 cross-region disaster recovery report, including CloudPcId, UserId, DeviceId, CloudPCDeviceDisplayName, UserPrincipalName, IsCrossRegionEnabled, CrossRegionHealthStatus, LicenseType, DisasterRecoveryStatus, CurrentRestorePointDateTime, and ActivationExpirationDateTime."

+ms.localizationpriority: medium

+# cloudPcReports: retrieveCrossregionDisasterRecoveryReport

+Namespace: microsoft.graph

+Retrieve the Windows 365 cross-region disaster recovery report, including CloudPcId, UserId, DeviceId, CloudPCDeviceDisplayName, UserPrincipalName, IsCrossRegionEnabled, CrossRegionHealthStatus, LicenseType, DisasterRecoveryStatus, CurrentRestorePointDateTime, and ActivationExpirationDateTime.

+## 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": "cloudpcreports_retrievecrossregiondisasterrecoveryreport" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /deviceManagement/virtualEndpoint/reports/retrieveCrossRegionDisasterRecoveryReport

+```

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

+The following table shows the parameters that you can use with this action.

+| Parameter | Type | Description |

+| : | :- | :- |

+| filter | String | OData `$filter` syntax. The supported filters are: `and`, `or`, `lt`, `le`, `gt`, `ge`, and `eq`. |

+| groupBy | String collection | Specifies how to group the reports. If used, must have the same content as the **select** parameter. |

+| orderBy | String collection | Specifies how to sort the reports. |

+| search | String | Specifies a String to search. |

+| select | String collection | OData `$select` syntax. The selected columns of the reports. |

+| skip | Int32 | The number of records to skip. |

+| top | Int32 | The number of top records to return. |

+## Response

+If successful, this action returns a `200 OK` response code and a Stream in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "cloudpcreportsthis.retrievecrossregiondisasterrecoveryreport"

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/retrievecrossregiondisasterrecoveryreport

+Content-Type: application/json

+Content-length: 199

+{

+ "filter": "DisasterRecoveryStatus eq 'Active outage'",

+ "select": [

+ "Id",

+ "CloudPcId",

+ "UserId",

+ "UserSettingId",

+ "DeviceId",

+ "CloudPCDeviceDisplayName",

+ "UserPrincipalName",

+ "IsCrossRegionEnabled",

+ "CrossRegionHealthStatus",

+ "LicenseType",

+ "DisasterRecoveryStatus",

+ "CurrentRestorePointDateTime",

+ "ActivationExpirationDateTime"

+ ],

+ "skip": 0,

+ "top": 50

+}

+```

+### Response

+The following example shows the response.

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

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Edm.Stream"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/octet-stream

+{

+ "TotalRowCount": 1,

+ "Schema": [

+ {

+ "Column": "Id",

+ "PropertyType": "String"

+ },

+ {

+ "Column": "CloudPcId",

+ "PropertyType": "String"

+ },

+ {

+ "Column": "UserId",

+ "PropertyType": "String"

+ },

+ {

+ "Column": "UserSettingId",

+ "PropertyType": "String"

+ },

+ {

+ "Column": "DeviceId",

+ "PropertyType": "String"

+ },

+ {

+ "Column": "CloudPcDeviceDisplayName",

+ "PropertyType": "String"

+ },

+ {

+ "Column": "UserPrincipalName",

+ "PropertyType": "String"

+ },

+ {

+ "Column": "IsCrossRegionEnabled",

+ "PropertyType": "Boolean"

+ },

+ {

+ "Column": "CrossRegionHealthStatus",

+ "PropertyType": "String"

+ },

+ {

+ "Column": "LicenseType",

+ "PropertyType": "String"

+ },

+ {

+ "Column": "DisasterRecoveryStatus",

+ "PropertyType": "String"

+ },

+ {

+ "Column": "CurrentRestorePointDateTime",

+ "PropertyType": "DateTime"

+ },

+ {

+ "Column": "ActivationExpirationDateTime",

+ "PropertyType": "DateTime"

+ }

+ ],

+ "Values": [

+ [

+ "7768debd-7955-4b32-a654-a02894bce953",

+ "69360332-619a-4b38-af5d-91ecef72f789",

+ "c939b389-979f-4687-945d-d1220b3d4d24",

+ "k739b389-979f-4j87-945d-d3220b3d4o24",

+ "9330ff50-0a1b-4038-8fe8-3c4a67ec4dc5",

+ "CPC-Cross-JG79E",

+ "john.doe@contoso.com",

+ true,

+ "Unhealthy:'ANC unhealthy', 'Network mismatch'",

+ "Cross Region",

+ "Active outage",

+ "2023-10-16 03:05:14.131 AM",

+ "2023-10-19 07:05:14.131 AM"

+ ]

+ ]

+}

+```

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+| 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"

+ }

+ ]

+ }

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [CLI](#tab/cli)

+# [Go](#tab/go)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [PHP](#tab/php)

+# [PowerShell](#tab/powershell)

+# [Python](#tab/python)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [CLI](#tab/cli)

+# [Go](#tab/go)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [PHP](#tab/php)

+# [PowerShell](#tab/powershell)

+# [Python](#tab/python)

+ Title: "driveItem: discardCheckout"

+description: "Discard a previously checked out driveItem."

+ms.localizationpriority: medium

+# driveItem: discardCheckout

+Namespace: microsoft.graph

+Discard the check out of a [driveItem](../resources/driveitem.md). This action releases a **driveItem** resource that was previously [checked out](driveitem-checkout.md). Any changes made to the item while it was checked out are discarded.

+The same user that performed the checkout must discard it. Another alternative is to use application permissions.

+## 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-discardcheckout-permissions"

+}

+-->

+## HTTP request

+``` http

+POST /drive/root/discardCheckout

+POST /drives/{drivesId}/root/discardCheckout

+POST /shares/{sharesId}/root/discardCheckout

+POST /drive/items/{driveItemId}/discardCheckout

+POST /shares/{sharesId}/driveItem/discardCheckout

+POST /drive/bundles/{driveItemId}/discardCheckout

+POST /drive/special/{driveItemId}/discardCheckout

+POST /drive/following/{driveItemId}/discardCheckout

+```

+## 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 discard checkout request on a file identified by `{item-id}`.

+<!-- {

+ "blockType": "request",

+ "name": "driveitemthis.discardcheckout"

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/discardCheckout

+```

+### Response

+The following example shows the response.

+<!-- { "blockType": "response" } -->

+```http

+HTTP/1.1 204 No content

+```

+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"

+} -->

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed. The following properties can be updated.

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

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

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

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

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+ Title: "managedDevice: getCloudPcRemoteActionResults (deprecated)"

+# managedDevice: getCloudPcRemoteActionResults (deprecated)

+> [!CAUTION]

+> This API is deprecated and will stop returning data on September 30, 2024. Going forward, use the [retrieveCloudPcRemoteActionResults](../api/cloudpc-retrievecloudpcremoteactionresults.md) API.

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

+ Title: "message: recall"

+description: "Recall a message in the specified user's mailbox Sent Items folder."

+ms.localizationpriority: medium

+# message: recall

+Namespace: microsoft.graph

+Recall a message in the specified user's mailbox Sent Items folder.

+## 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": "message_recall" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /me/mailFolders/sentitems/messages/{id}/recall

+POST /users/{id | userPrincipalName}/mailFolders/sentitems/messages/{id}/recall

+```

+## Request headers

+| Header | Value |

+|:-|:|

+| 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 `202 Accepted` response code and a string that contains server information in the response body.

+If the ID is invalid, this method returns a `400 Bad request` and the detailed error information in the response body.

+## Example

+The following example shows how to call this API.

+### Request

+The following request recalls the specified message in the specified user's mailbox sent items folder.

+> **Note:** The ID here is shortened for readability.

+```http

+POST https://graph.microsoft.com/beta/me/mailFolders/sentitems/messages/AAMkADhAAATs28OAAA=/recall

+```

+### Response

+The following example shows the response.

+``` http

+HTTP/1.1 202 Accepted

+Content-Type: application/json

+{

+ "Successfully submitted recall request to Hub server LV8PR00MB1800.NAMPRD00.PROD.OUTLOOK.COM, MessageId is CSRUBSZRRANU4.HEXMGAAG0OPH2@dm6pr00mb0830."

+}

+```

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

+<!-- { "blockType": "ignored", "name": "onlinemeeting_list_recordings" } -->

+|Permission type|Least privileged permissions|Higher privileged permissions|

+|:|:|:|

+|Delegated (work or school account)|OnlineMeetingRecording.Read.All|Not available.|

+|Delegated (personal Microsoft account)|Not supported.|Not supported.|

+|Application|OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read.Chat|Not available.|

+<!-- { "blockType": "ignored", "name": "onlinemeeting_list_transcripts" } -->

+|Permission type|Least privileged permissions|Higher privileged permissions|

+|:|:|:|

+|Delegated (work or school account)|OnlineMeetingTranscript.Read.All|Not available.|

+|Delegated (personal Microsoft account)|Not supported.|Not supported.|

+|Application|OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat|Not available.|

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+>**Note:**

+> * Inviting multiple participants in one request is only supported for group calls.

+> * Inviting more than one bot to a meeting or group call isn't allowed.

+The invite API supports only one participant when you replace an existing peer-to-peer call. When multiple participants are provided in the request body, only the first participant is read and the rest of the participants are ignored.

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+ Title: "List relatedHosts"

+description: "Get a list of related host resources associated with an sslCertificate."

+ms.localizationpriority: medium

+# List relatedHosts

+Namespace: microsoft.graph.security

+Get a list of related [host](../resources/security-host.md) resources associated with an [sslCertificate](../resources/security-sslcertificate.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": "security_sslcertificate_list_relatedhosts" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET security/threatIntelligence/sslCertificates/{sslCertificateId}/relatedHosts

+```

+## Optional query parameters

+This method supports the `$count`, `$skip`, and `$top` 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 [microsoft.graph.security.host](../resources/security-host.md) objects in the response body.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "list_relatedHost",

+ "sampleKeys": ["MDJjODMzNDIzYzYwOTIzNjM1YTA0OTRhMmI2NThjYWM5NDFmM2FmMA=="]

+}

+-->

+``` http

+GET https://graph.microsoft.com/betJjODMzNDIzYzYwOTIzNjM1YTA0OTRhMmI2NThjYWM5NDFmM2FmMA==/relatedHosts

+```

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

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.security.host)",

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.security.ipAddress",

+ "id": "20.112.250.133",

+ "firstSeenDateTime": null,

+ "lastSeenDateTime": null,

+ "countryOrRegion": null,

+ "netblock": null,

+ "autonomousSystem": null,

+ "hostingProvider": null

+ },

+ {

+ "@odata.type": "#microsoft.graph.security.ipAddress",

+ "id": "20.231.239.246",

+ "firstSeenDateTime": null,

+ "lastSeenDateTime": null,

+ "countryOrRegion": null,

+ "netblock": null,

+ "autonomousSystem": null,

+ "hostingProvider": null

+ },

+ {

+ "@odata.type": "#microsoft.graph.security.ipAddress",

+ "id": "20.236.44.162",

+ "firstSeenDateTime": null,

+ "lastSeenDateTime": null,

+ "countryOrRegion": null,

+ "netblock": null,

+ "autonomousSystem": null,

+ "hostingProvider": null

+ }

+ ]

+}

+```

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

+### Example 1: Install an app in a chat

+### Example 2: Install an app in a team with consent to the resource-specific permissions required by the app

+If your call results in an error message that states `The required permissions have not been consented to by the caller`, the request body doesn't specify all the RSC permissions required by the app to which the user must grant consent. Make sure that you build your request as shown in the [example](#request-1).

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+ "displayName": "BulkPowerOn on 2024-6-14 17:05:43 GMT-0300 (French Guiana Time)",

+ "id": "0d76d02b-e0a0-4f58-baff-d1718cc2d144",

+ "cloudPcIds": [],

+ "scheduledDuringMaintenanceWindow": false,

+ "createdDateTime": "2024-06-14T20:05:44.5239567Z",

+ "status": "succeeded",

+ "initiatedByUserPrincipalName": "johnd@contoso.com",

+ "actionSummary": null

+ "deviceRegionName": "eastus2",

+ "deviceRegionName": "eastus2",

+ "deviceRegionName": "eastus2",

+ "actionSummary": null,

+ "initiatedByUserPrincipalName": "johnd@contoso.com",

+ "status": "pending",

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

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [CLI](#tab/cli)

+# [Go](#tab/go)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [PHP](#tab/php)

+# [Python](#tab/python)

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

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [CLI](#tab/cli)

+# [Go](#tab/go)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [PHP](#tab/php)

+# [PowerShell](#tab/powershell)

+# [Python](#tab/python)

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

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

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

+}

+-->

+```msgraph-interactive

+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'

+```

+# [C#](#tab/csharp)

+# [CLI](#tab/cli)

+# [Go](#tab/go)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [PHP](#tab/php)

+# [PowerShell](#tab/powershell)

+# [Python](#tab/python)

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

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

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

+}

+-->

+```msgraph-interactive

+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'

+```

+# [C#](#tab/csharp)

+# [CLI](#tab/cli)

+# [Go](#tab/go)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [PHP](#tab/php)

+# [PowerShell](#tab/powershell)

+# [Python](#tab/python)

+#### 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: "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.

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [JavaScript](#tab/javascript)

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

+# [HTTP](#tab/http)

+<!-- {

+ "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"

+ ],

+}

+```

+# [JavaScript](#tab/javascript)

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

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [JavaScript](#tab/javascript)

+``` 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

+}

+```

+ Title: "Delete virtualEventRegistrationQuestionBase"

+description: "Delete a registration question from a webinar."

+ms.localizationpriority: medium

+# Delete virtualEventRegistrationQuestionBase

+Namespace: microsoft.graph

+Delete a registration question from a [webinar](../resources/virtualeventwebinar.md). The question can either be 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": "virtualeventregistrationquestionbase_delete" } -->

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+DELETE /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration/questions/{questionId}

+```

+## 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 `204 No Content` response code.

+## Examples

+### Request

+The following example shows a request.

+<!-- {

+ "blockType": "request",

+ "name": "delete_virtualeventregistrationquestion",

+ "sampleKeys": ["f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143", "f3115d4c-9896-42fc-a649-8ca5e3c3a43f"]

+}

+-->

+``` http

+DELETE https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrationConfiguration/questions/f3115d4c-9896-42fc-a649-8ca5e3c3a43f

+```

+### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

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

+You can specify the following properties when you create a **virtualEventRegistration** with delegated permission.

+|Property|Type|Description|

+|:|:|:|

+|preferredTimezone|String|The registrant's time zone details. Required. |

+|preferredLanguage|String|The registrant's preferred language. Required. |

+|registrationQuestionAnswers|[virtualEventRegistrationQuestionAnswer](../resources/virtualeventregistrationquestionanswer.md) collection|The registrant's answer to the registration questions. Optional. |

+You can specify the following properties when you create a **virtualEventRegistration** with application permission.

+|Property|Type|Description|

+|:|:|:|

+|firstName|String|The registrant's first name. Required. |

+|lastName|String|The registrant's last name. Required. |

+|email|String|The registrant's email address. Required. |

+|preferredTimezone|String|The registrant's time zone details. Required. |

+|preferredLanguage|String|The registrant's preferred language. Required. |

+|registrationQuestionAnswers|[virtualEventRegistrationQuestionAnswer](../resources/virtualeventregistrationquestionanswer.md) collection|The registrant's answer to the registration questions. Optional. |

+## 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](/entra/fundamentals/whatis) as a way to register a Microsoft Entra user to a webinar.

+#### Request

+The following example shows a request.

+# [HTTP](#tab/http)

+<!-- {

+ "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"

+ ]

+ }

+ ]

+}

+```

+# [C#](#tab/csharp)

+# [CLI](#tab/cli)

+# [Go](#tab/go)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [PHP](#tab/php)

+# [PowerShell](#tab/powershell)

+# [Python](#tab/python)

+#### 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](/entra/fundamentals/whatis) as a way to register an anonymous user for a webinar.

+#### Request

+The following example shows a request.

+# [HTTP](#tab/http)

+<!-- {

+ "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"

+ ]

+ }

+ ]

+}

+```

+# [C#](#tab/csharp)

+# [CLI](#tab/cli)

+# [Go](#tab/go)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [PHP](#tab/php)

+# [PowerShell](#tab/powershell)

+# [Python](#tab/python)

+#### Response

+The following example shows the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

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

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+|[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.|

+description: "Represents the Microsoft 365 Backup Storage service in a tenant."

+toc. Title: Backup restore

+|customerNotes|String|Notes from the customer associated with this appointment. You can get the value only when you read this **bookingAppointment** by its ID. You can set this property only when you initially create an appointment with a new customer.|

+| [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.|

+|[Retrieve remote action results](../api/cloudpc-retrievecloudpcremoteactionresults.md)|[cloudPcRemoteActionResult](../resources/cloudpcremoteactionresult.md) collection|Retrieve [remote action results](../resources/cloudpcremoteactionresult.md) and check the status of a specific remote action performed on the associated Cloud PC device.|

+|[Get remote action results (deprecated)](../api/manageddevice-getcloudpcremoteactionresults.md)|[cloudPcRemoteActionResult](../resources/cloudpcremoteactionresult.md)|Check the [Cloud PC-specified remote action results](../resources/cloudpcremoteactionresult.md) for a Cloud PC device. This API is deprecated and will stop returning data on September 30, 2024. Going forward, use the [retrieveCloudPcRemoteActionResults](../api/cloudpc-retrievecloudpcremoteactionresults.md) API.|

+|[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"

+Base type of [cloudPcBulkDisasterRecoveryFailback](../resources/cloudpcbulkdisasterrecoveryfailback.md), [cloudPcBulkDisasterRecoveryFailover](../resources/cloudpcbulkdisasterrecoveryfailover.md), [cloudPcBulkPowerOff](../resources/cloudpcbulkpoweroff.md), [cloudPcBulkPowerOn](../resources/cloudpcbulkpoweron.md), [cloudPcBulkReprovision](../resources/cloudpcbulkreprovision.md), [cloudPcBulkResize](../resources/cloudpcbulkresize.md), [cloudPcBulkRestart](../resources/cloudpcbulkrestart.md), [cloudPcBulkRestore](../resources/cloudpcbulkrestore.md), and [cloudPcBulkTroubleshoot](../resources/cloudpcbulktroubleshoot.md).

+|initiatedByUserPrincipalName|String|Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only.|

+|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk action is scheduled according to the maintenance window. When `true`, the bulk action uses the maintenance window to schedule the action; `false` means that the bulk action doesn't use the maintenance window. The default value is `false`.|

+|status|[cloudPcBulkActionStatus](#cloudpcbulkactionstatus-values)|Indicates the status of bulk actions. Possible values are `pending`, `succeeded`, `failed`, `unknownFutureValue`. The default value is `pending`. Read-only.|

+### cloudPcBulkActionStatus values

+|Member|Description|

+|:|:|

+|pending|Default. Indicates the status of the bulk action as `pending` because some of the bulk actions are still in progress and not yet completed.|

+|succeeded|Indicates the status of the bulk action as `succeeded` for all associated actions.|

+|failed|Indicates the status of the bulk action as `failed` for all associated actions.|

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

+ "initiatedByUserPrincipalName": "String",

+ "scheduledDuringMaintenanceWindow": "Boolean",

+ "status": "String"

+ Title: "cloudPcBulkDisasterRecoveryFailback resource type"

+description: "Represents the entity that performs a bulk disaster recovery failback action."

+ms.localizationpriority: medium

+# cloudPcBulkDisasterRecoveryFailback resource type

+Namespace: microsoft.graph

+Represents the entity that performs a bulk disaster recovery failback action. This action initiates the deactivation of cross-region disaster recovery that restores the Cloud PC to its original region when the regional outage is resolved.

+Inherits from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|actionSummary|[cloudPcBulkActionSummary](../resources/cloudpcbulkactionsummary.md)|Run summary of this bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|cloudPcIds|String collection|IDs of the Cloud PCs the bulk action applies to. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|createdDateTime|DateTimeOffset|The date and time when the bulk action was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|displayName|String|Name of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|id|String|ID of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|initiatedByUserPrincipalName|String|Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk action is scheduled according to the maintenance window. When `true`, the bulk action uses the maintenance window to schedule the action; `false` means that the bulk action doesn't use the maintenance window. The default value is `false`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|status|[cloudPcBulkActionStatus](../resources/cloudpcbulkaction.md#cloudpcbulkactionstatus-values)|Indicates the status of bulk actions. Possible values are `pending`, `succeeded`, `failed`, `unknownFutureValue`. The default value is `pending`. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+## Relationships

+None.

+## JSON representation

+The following JSON representation shows the resource type.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

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

+ "baseType": "microsoft.graph.cloudPcBulkAction",

+ "openType": false

+}

+-->

+``` json

+{

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

+ "actionSummary": {"@odata.type": "microsoft.graph.cloudPcBulkActionSummary"},

+ "cloudPcIds": ["String"],

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

+ "displayName": "String",

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

+ "initiatedByUserPrincipalName": "String",

+ "scheduledDuringMaintenanceWindow": "Boolean",

+ "status": "String"

+}

+```

+ Title: "cloudPcBulkDisasterRecoveryFailover resource type"

+description: "Represents the entity that performs a bulk disaster recovery failover action."

+ms.localizationpriority: medium

+# cloudPcBulkDisasterRecoveryFailover resource type

+Namespace: microsoft.graph

+Represents the entity that performs a bulk disaster recovery failover action. This action initiates the activation of cross-region disaster recovery that restores a temporary Cloud PC in the backup region from a cross-region snapshot if the original region experiences an outage.

+Inherits from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|actionSummary|[cloudPcBulkActionSummary](../resources/cloudpcbulkactionsummary.md)|Run summary of this bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|cloudPcIds|String collection|IDs of the Cloud PCs the bulk action applies to. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|createdDateTime|DateTimeOffset|The date and time when the bulk action was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|displayName|String|Name of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|id|String|ID of the bulk action. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|initiatedByUserPrincipalName|String|Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk action is scheduled according to the maintenance window. When `true`, the bulk action uses the maintenance window to schedule the action; `false` means that the bulk action doesn't use the maintenance window. The default value is `false`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|status|[cloudPcBulkActionStatus](../resources/cloudpcbulkaction.md#cloudpcbulkactionstatus-values)|Indicates the status of bulk actions. Possible values are `pending`, `succeeded`, `failed`, `unknownFutureValue`. The default value is `pending`. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+## Relationships

+None.

+## JSON representation

+The following JSON representation shows the resource type.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

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

+ "baseType": "microsoft.graph.cloudPcBulkAction",

+ "openType": false

+}

+-->

+``` json

+{

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

+ "actionSummary": {"@odata.type": "microsoft.graph.cloudPcBulkActionSummary"},

+ "cloudPcIds": ["String"],

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

+ "displayName": "String",

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

+ "initiatedByUserPrincipalName": "String",

+ "scheduledDuringMaintenanceWindow": "Boolean",

+ "status": "String"

+}

+```

+|initiatedByUserPrincipalName|String|Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk action is scheduled according to the maintenance window. When `true`, the bulk action uses the maintenance window to schedule the action; `false` means that the bulk action doesn't use the maintenance window. The default value is `false`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|status|[cloudPcBulkActionStatus](../resources/cloudpcbulkaction.md#cloudpcbulkactionstatus-values)|Indicates the status of bulk actions. Possible values are `pending`, `succeeded`, `failed`, `unknownFutureValue`. The default value is `pending`. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

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

+ "initiatedByUserPrincipalName": "String",

+ "scheduledDuringMaintenanceWindow": "Boolean",

+ "status": "String"

+|initiatedByUserPrincipalName|String|Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk action is scheduled according to the maintenance window. When `true`, the bulk action uses the maintenance window to schedule the action; `false` means that the bulk action doesn't use the maintenance window. The default value is `false`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|status|[cloudPcBulkActionStatus](../resources/cloudpcbulkaction.md#cloudpcbulkactionstatus-values)|Indicates the status of bulk actions. Possible values are `pending`, `succeeded`, `failed`, `unknownFutureValue`. The default value is `pending`. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

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

+ "initiatedByUserPrincipalName": "String",

+ "scheduledDuringMaintenanceWindow": "Boolean",

+ "status": "String"

+|initiatedByUserPrincipalName|String|Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk action is scheduled according to the maintenance window. When `true`, the bulk action uses the maintenance window to schedule the action; `false` means that the bulk action doesn't use the maintenance window. The default value is `false`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|status|[cloudPcBulkActionStatus](../resources/cloudpcbulkaction.md#cloudpcbulkactionstatus-values)|Indicates the status of bulk actions. Possible values are `pending`, `succeeded`, `failed`, `unknownFutureValue`. The default value is `pending`. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

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

+ "initiatedByUserPrincipalName": "String",

+ "scheduledDuringMaintenanceWindow": "Boolean",

+ "status": "String"

+|initiatedByUserPrincipalName|String|Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk action is scheduled according to the maintenance window. When `true`, the bulk action uses the maintenance window to schedule the action; `false` means that the bulk action doesn't use the maintenance window. The default value is `false`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|status|[cloudPcBulkActionStatus](../resources/cloudpcbulkaction.md#cloudpcbulkactionstatus-values)|Indicates the status of bulk actions. Possible values are `pending`, `succeeded`, `failed`, `unknownFutureValue`. The default value is `pending`. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+ "targetServicePlanId": "String",

+ "initiatedByUserPrincipalName": "String",

+ "scheduledDuringMaintenanceWindow": "Boolean",

+ "status": "String"

+|initiatedByUserPrincipalName|String|Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk action is scheduled according to the maintenance window. When `true`, the bulk action uses the maintenance window to schedule the action; `false` means that the bulk action doesn't use the maintenance window. The default value is `false`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|status|[cloudPcBulkActionStatus](../resources/cloudpcbulkaction.md#cloudpcbulkactionstatus-values)|Indicates the status of bulk actions. Possible values are `pending`, `succeeded`, `failed`, `unknownFutureValue`. The default value is `pending`. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+The following JSON representation shows the resource type.

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

+ "initiatedByUserPrincipalName": "String",

+ "scheduledDuringMaintenanceWindow": "Boolean",

+ "status": "String"

+|initiatedByUserPrincipalName|String|Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk action is scheduled according to the maintenance window. When `true`, the bulk action uses the maintenance window to schedule the action; `false` means that the bulk action doesn't use the maintenance window. The default value is `false`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|status|[cloudPcBulkActionStatus](../resources/cloudpcbulkaction.md#cloudpcbulkactionstatus-values)|Indicates the status of bulk actions. Possible values are `pending`, `succeeded`, `failed`, `unknownFutureValue`. The default value is `pending`. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+ "initiatedByUserPrincipalName": "String",

+ "scheduledDuringMaintenanceWindow": "Boolean",

+ "status": "String",

+|initiatedByUserPrincipalName|String|Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk action is scheduled according to the maintenance window. When `true`, the bulk action uses the maintenance window to schedule the action; `false` means that the bulk action doesn't use the maintenance window. The default value is `false`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

+|status|[cloudPcBulkActionStatus](../resources/cloudpcbulkaction.md#cloudpcbulkactionstatus-values)|Indicates the status of bulk actions. Possible values are `pending`, `succeeded`, `failed`, `unknownFutureValue`. The default value is `pending`. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|

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

+ "initiatedByUserPrincipalName": "String",

+ "scheduledDuringMaintenanceWindow": "Boolean",

+ "status": "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)"

+| reportName | [cloudPcReportName](#cloudpcreportname-values) | The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `rawRemoteConnectionReports`, `cloudPcUsageCategoryReports`, `crossRegionDisasterRecoveryReport`. 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): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `rawRemoteConnectionReports`, `cloudPcUsageCategoryReports`, `crossRegionDisasterRecoveryReport`.|

+| crossRegionDisasterRecoveryReport | The cross-region disaster recovery status for Cloud PCs. |

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

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

+|[Retrieve remote action results](../api/cloudpc-retrievecloudpcremoteactionresults.md)|[cloudPcRemoteActionResult](../resources/cloudpcremoteactionresult.md) collection|Retrieve [remote action results](../resources/cloudpcremoteactionresult.md) and check the status of a specific remote action performed on the associated Cloud PC device.|

+|[Get remote action results (deprecated)](../api/manageddevice-getcloudpcremoteactionresults.md)|[cloudPcRemoteActionResult](../resources/cloudpcremoteactionresult.md)|Check the [Cloud PC-specified remote action results](../resources/cloudpcremoteactionresult.md) for a Cloud PC device. This API is deprecated and will stop returning data on September 30, 2024. Going forward, use the [retrieveCloudPcRemoteActionResults](../api/cloudpc-retrievecloudpcremoteactionresults.md) API.|

+|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"

+|[getFrontlineReport](../api/cloudpcreports-getfrontlinereport.md)|Stream| Get Frontline Cloud PC license usage reports, such as **servicePlanId**, **licenseCount**, and **claimedLicenseCount**, for real-time, 7 days, or 28 days trend.|

+|[getRawRemoteConnectionReports](../api/cloudpcreports-getrawremoteconnectionreports.md)|Stream|Get the raw real-time remote connection report for a Cloud PC without any calculation or aggregation.|

+|[retrieveCrossRegionDisasterRecoveryReport](../api/cloudpcreports-retrievecrossregiondisasterrecoveryreport.md)|Stream| Retrieve the Windows 365 cross-region disaster recovery report with configuration health check results, disaster recovery status, latest cross-region restore points, and user settings.|

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

+|IVR calls | [call](/graph/api/resources/call?view=graph-rest-beta&preserve-view=true&preserve-view=true) | [Methods for IVR](/graph/api/resources/teams-api-overview#ivr-scenarios?view=graph-rest-beta?&preserve-view=true&preserve-view=true)

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

+| [Discard checkout](../api/driveitem-discardcheckout.md) | None| Discard a previously [checked out](../api/driveitem-checkout.md) **driveItem**.|

+| [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 |

+### appManagementRestrictionState values

+|Member|

+|:|

+|enabled|

+|disabled|

+|unknownFutureValue|

+|sender|[recipient](recipient.md)|The account that is used to generate the message. In most cases, this value is the same as the **from** property. You can set this property to a different value when sending a message from a [shared mailbox](/exchange/collaboration/shared-mailboxes/shared-mailboxes), [for a shared calendar, or as a delegate](/graph/outlook-share-delegate-calendar). In any case, the value must correspond to the actual mailbox used. For more information, see [setting the from and sender properties](/graph/outlook-create-send-messages#setting-the-from-and-sender-properties).|

+|webLink|String|The URL to open the message in Outlook on the web.<br><br>You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout isn't present or if it's set to 1, then the message is shown in a popout window. If ispopout is set to 0, then the browser shows the message in the Outlook on the web review pane.<br><br>The message opens in the browser if you're logged in to your mailbox via Outlook on the web. You are prompted to login if you aren't already logged in with the browser.<br><br>This URL can't be accessed from within an iFrame.|

+|mentions|[mention](mention.md) collection | A collection of mentions in the message, ordered by the **createdDateTime** from the newest to the oldest. By default, a `GET` /messages doesn't return this property unless you apply `$expand` on the property.|

+|[Recall message](../api/message-recall.md)|[message](message.md)|Recall a message in the specified user's mailbox Sent Items folder.|

+|[Recall message](../api/message-recall.md)|[message](message.md)|Recall a message in the specified user's mailbox Sent Items folder.|

+|[Recall message](../api/message-recall.md)|[message](message.md)|Recall a message in the specified user's mailbox Sent Items folder.|

+|sender|[recipient](recipient.md)|The account that is used to generate the message. In most cases, this value is the same as the **from** property. You can set this property to a different value when sending a message from a [shared mailbox](/exchange/collaboration/shared-mailboxes/shared-mailboxes), [for a shared calendar, or as a delegate](/graph/outlook-share-delegate-calendar). In any case, the value must correspond to the actual mailbox used. Find out more about [setting the from and sender properties](/graph/outlook-create-send-messages#setting-the-from-and-sender-properties) of a message.|

+|webLink|String|The URL to open the message in Outlook on the web.<br><br>You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout isn't present or if it's set to 1, then the message is shown in a popout window. If ispopout is set to 0, then the browser shows the message in the Outlook on the web review pane.<br><br>The message opens in the browser if you're logged in to your mailbox via Outlook on the web. You are prompted to login if you aren't already logged in with the browser.<br><br>This URL can't be accessed from within an iFrame.|

+|mentions|[mention](mention.md) collection | A collection of mentions in the message, ordered by the **createdDateTime** from the newest to the oldest. By default, a `GET` /messages doesn't return this property unless you apply `$expand` on the property.|

+|[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.|

+description: "Represents a key credential configuration object that contains properties to configure application certificate restrictions."

+Represents a key credential configuration object that contains properties to configure application certificate restriction.

+| Property | Type | Description |

+| : | : | : |

+| certificateBasedApplicationConfigurationIds | Collection(String) | Collection of GUIDs that represent [certificateBasedApplicationConfiguration](../resources/certificatebasedapplicationconfiguration.md) that is allowed as root and intermediate certificate authorities.|

+| maxLifetime | Duration | String value that indicates the maximum lifetime for key expiration, defined as an ISO 8601 duration. For example, `P4DT12H30M5S` represents four days, 12 hours, 30 minutes, and five seconds. This property is required when **restrictionType** is set to `keyLifetime`.|

+| restrictForAppsCreatedAfterDateTime | DateTimeOffset | Specifies the date from which the policy restriction applies to newly created applications. For existing applications, the enforcement date can be retroactively applied.|

+| restrictionType | appKeyCredentialRestrictionType | The type of restriction being applied. Possible values are `asymmetricKeyLifetime`, and `unknownFutureValue`. Each value of restrictionType can be used only once per policy.|

+| state | appManagementRestrictionState | String value that indicates if the restriction is evaluated. The possible values are: `enabled`, `disabled`, and `unknownFutureValue`. If `enabled`, the restriction is evaluated. If `disabled`, the restriction isn't evaluated or enforced.|

+The following JSON representation shows the resource type.

+ "restrictionType": {

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

+ },

+ "state": {

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

+ },

+ "restrictForAppsCreatedAfterDateTime": "String (DateTime)",

+ "maxLifetime": "String (ISO 8601 duration)",

+ "certificateBasedApplicationConfigurationIds": [

+ "String (Guid)"

+ ]

+|[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. |

+|[Recall message](../api/message-recall.md)|[message](message.md)|Recall a message in the specified user's mailbox Sent Items folder.|

+|[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.|

+| Property | Type | Description |

+| : | : | : |

+| maxLifetime | Duration | String value that indicates the maximum lifetime for password expiration, defined as an ISO 8601 duration. For example, `P4DT12H30M5S` represents four days, 12 hours, 30 minutes, and five seconds. This property is required when **restrictionType** is set to `passwordLifetime`.|

+| restrictForAppsCreatedAfterDateTime | DateTimeOffset | Specifies the date from which the policy restriction applies to newly created applications. For existing applications, the enforcement date can be retroactively applied.|

+| restrictionType | appCredentialRestrictionType | The type of restriction being applied. The possible values are: `passwordAddition`, `passwordLifetime`, `symmetricKeyAddition`, `symmetricKeyLifetime`,`customPasswordAddition`, and `unknownFutureValue`. Each value of restrictionType can be used only once per policy.|

+| state | appManagementRestrictionState | String value that indicates if the restriction is evaluated. The possible values are: `enabled`, `disabled`, and `unknownFutureValue`. If `enabled`, the restriction is evaluated. If `disabled`, the restriction isn't evaluated or enforced.|

+The following JSON representation shows the resource.

+ "state": {

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

+ },

+ "restrictForAppsCreatedAfterDateTime": "String (DateTime)",

+ "maxLifetime": "String (ISO 8601 duration)"

+toc. Title: Protection policy

+toc. Title: Protection rule

+toc. Title: Protection unit

+This resource is an abstract type.

+|id|String|The unique identifier of the protection unit.|

+|protectRequested | Protection of the unit was requested. |

+|unprotectRequested | Disabling protection of the unit was requested. |

+|removeRequested |A request to remove the protected unit from the policy was made. |

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

+| [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. |

+toc. Title: Restore artifact

+toc. Title: Restore session

+Represents a restore session for a [protection unit](protectionunitbase.md) that's protected by a [protection policy](protectionpolicybase.md). APIs are used by Global Admin or SharePoint Online Admin for SharePoint Online/OneDrive & Exchange Online Admin for Exchange Online to perform restore related tasks on artifacts that are protected as part of Protection Policy.

+|status|[restoreSessionStatus](../resources/restoresessionbase.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.|

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

+|[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.|

+| Method |Return type|Description|

+|:--|:|:|

+| [List](../api/security-threatintelligence-list-sslcertificates.md) |[microsoft.graph.security.sslCertificate](../resources/security-sslcertificate.md) collection|Get a list of [sslCertificate](../resources/security-sslcertificate.md) objects and their properties.|

+| [Get](../api/security-sslcertificate-get.md) |[microsoft.graph.security.sslCertificate](../resources/security-sslcertificate.md)|Get the properties and relationships of an [sslCertificate](../resources/security-sslcertificate.md) object.|

+| [List related hosts](../api/security-sslcertificate-list-relatedhosts.md) |[microsoft.graph.security.host](../resources/security-host.md) collection|Get a list of related [host](../resources/security-host.md) resources associated with an [sslCertificate](../resources/security-sslcertificate.md).|

+|relatedHosts|[microsoft.graph.security.host](../resources/security-host.md) collection|The **host** resources related with this **sslCertificate**.|

+The following JSON representation shows the resource type.

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

+Microsoft Teams is a chat-based workspace in Microsoft 365 that provides built-in access to team-specific calendars, files, OneNote notes, Planner plans, Shifts schedules, and more. You can use the Microsoft Graph API to integrate with Microsoft Teams features.

+The following table lists common use cases for Microsoft Teams APIs in Microsoft Graph.

+| Connect bots to calls and implement interactive voice response (IVR) | [call](../resources/call.md) | [IVR scenarios](#ivr-scenarios) |

+### IVR scenarios

+The following are the Interactive Voice Response (IVR) scenarios that the calling APIs in Microsoft Graph support:

+- [Play an audio prompt](/graph/api/call-playprompt) - for example, when a call is placed in a customer service agent's queue.

+- [Record a response](/graph/api/call-record) - for example, to record the caller's audio, usually after they heard a prompt with options.

+- [Subscribe to tones](/graph/api/call-subscribetotone) - for example, when you want to know what DTMF tones the caller selected, usually after hearing the audio prompt.

+- [Cancel media processing](/graph/api/call-cancelmediaprocessing) - for example, when you want to cancel any **playPrompt** or **recordResponse** operations that might be in process.

+|[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/virtualeventwebinar-post-registrations.md)|[virtualEventRegistration](../resources/virtualeventregistration.md)|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).|

+|[Delete](../api/virtualeventregistrationquestionbase-delete.md)|None|Delete a registration question from 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.|

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed. Only the following properties are supported for update.

+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+| 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 the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+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: