Updates from: 06/24/2024 01:14:57
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Application Upsert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-upsert.md
PATCH /applications(uniqueName='{uniqueName}')
## Request headers | Name | Description| |:--|:-|
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | | Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. |
v1.0 Attachment Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/attachment-get.md
Use `$expand` to get the properties of an item attachment (contact, event, or me
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Basetask Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/basetask-delta.md
includes the encoded, desired parameters.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer | string | odata.maxpagesize={x}. Optional. | ## Request body
v1.0 Basetasklist Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/basetasklist-delta.md
includes the encoded, desired parameters.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer | string | odata.maxpagesize={x}. Optional. | ## Request body
v1.0 Calendar Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-delete.md
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}
## Request headers | Name | Type | Description| |:|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Calendar Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Calendar Getschedule https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-getschedule.md
POST /users/{id|userPrincipalName}/calendar/getSchedule
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity, which is application/json. Required. | | Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. |
v1.0 Calendar List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-list-calendarview.md
This method also supports some of the [OData Query Parameters](/graph/query-para
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | ## Request body
v1.0 Calendar List Events https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-list-events.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | ## Request body
v1.0 Calendargroup Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendargroup-delete.md
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Calendargroup Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendargroup-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Calendargroup List Calendars https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendargroup-list-calendars.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Channel Archive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-archive.md
Title: "channel: archive"
-description: "Archive a channel in a team. "
+description: "Archive a channel in a team."
ms.localizationpriority: medium
Namespace: microsoft.graph
Archive a [channel](../resources/channel.md) in a team. When a channel is archived, users can't send new messages or react to existing messages in the channel, edit the channel settings, or make other changes to the channel.
-You can delete an archived channel, or add and remove members from it. If you archive a team, its channels are archived for you.
+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 asynchronous; a channel is archived after the asynchronous archiving operation completes successfully, which might occur after the response returns.
+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.
+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 [unarchive](channel-unarchive.md) method. A channel canΓÇÖt be archived or unarchived if its team is 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.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
Choose the permission or permissions marked as least privileged for this API. Us
<!-- { "blockType": "permissions", "name": "channel_archive" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-archive-permissions.md)]
-> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
+> **Note**: This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't members of.
## HTTP request <!-- { "blockType": "ignored" } -->
POST /groups/{team-id}/team/channels/{channel-id}/archive
## Request headers
-| Header | Value |
-|:|:--|
-| Authorization | Bearer {token}. Required. |
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+| Content-Type | application/json. Optional. |
## Request body
-In the request, you can optionally include the `shouldSetSpoSiteReadOnlyForMembers` parameter in a JSON body, as follows.
-```JSON
+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
+ "shouldSetSpoSiteReadOnlyForMembers": true
} ```
-This optional parameter defines whether to set permissions for channel members to read-only on the SharePoint Online site associated with the team. Setting it to false or omitting the body altogether results in this step being skipped.
## Response
-If archiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header, which contains the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle archiving of the channel in a team. Check the status of the archiving operation by making a GET request to this location.
+If archiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header that specifies the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle the archiving of the channel in a team. Check the status of the archiving operation by making a GET request to this location.
## Examples
The following example shows a request to archive a channel.
#### Request
-# [HTTP](#tab/http)
<!-- { "blockType": "request",
- "name": "archive_channel"
+ "name": "archive_channel",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
}--> ```http
-POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/archive
+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 response.
The following example shows the response.
}--> ```http HTTP/1.1 202 Accepted
-Location: /teams/{team-id}/operations/{operation-id}
+Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba
Content-Type: text/plain Content-Length: 0 ``` ### Example 2: Archive a channel when the team is archived
-The following example shows a request when the **team is archived**.
+The following example shows a request to archive a channel that fails because the team is archived; the team must be active to archive or unarchive a channel.
#### Request
-<!-- { "blockType": "ignored" } -->
+<!-- {
+ "blockType": "request",
+ "name": "archive_channel_on_archived_team",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
+}-->
```http
-POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/archive
+POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/archive
``` #### Response
-The following example shows the `400` error response.
-
-<!-- { "blockType": "ignored" } -->
+The following example shows the `400 Bad Request` response code with a corresponding error message.
+<!-- {
+ "blockType": "response",
+ "name": "archive_channel_on_archived_team",
+ "@odata.type": "microsoft.graph.publicError",
+ "truncated": true
+}-->
```http http/1.1 400 Bad Request Content-Type: application/json
Content-Length: 193
} } }- ``` <!-- uuid: e848414b-4669-4484-ac36-1504c58a3fb8
v1.0 Channel Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-get.md
This method supports federation. Only a user who is a member of the shared chann
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).
-This API supports admin permissions. Global admins and Microsoft Teams service admins 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.
<!-- { "blockType": "permissions", "name": "channel_get" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-get-permissions.md)]
v1.0 Channel List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-list.md
Retrieve the list of [channels](../resources/channel.md) in this [team](../resou
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).
-This API supports admin permissions. Global admins and Microsoft Teams service admins 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.
<!-- { "blockType": "permissions", "name": "channel_list" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-list-permissions.md)]
v1.0 Channel Unarchive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-unarchive.md
Title: "channel: unarchive"
-description: "Restore an archived channel in a team. Unarchiving restores the ability for users to send messages and edit the channel."
+description: "Restore an archived channel in a team."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-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 [archive](channel-archive.md) API.
+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 unarchive operation completes successfully, which might occur after this method responds.
+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, an error will occur.
+> **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.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
Choose the permission or permissions marked as least privileged for this API. Us
<!-- { "blockType": "permissions", "name": "channel_unarchive" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-unarchive-permissions.md)]
-> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
+> **Note**: This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't a member of.
## HTTP request <!-- { "blockType": "ignored" } -->
POST /groups/{team-id}/team/channels/{channel-id}/unarchive
## Request headers
-| Header | Value |
-|:|:--|
-| Authorization | Bearer {token}. Required. |
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
Don't supply a request body for this method.
## Response
-If unarchiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header, which contains the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle unarchiving of the channel of the team. Check the status of the unarchiving operation by making a GET request to this location.
+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.
-## Example
+## Examples
### Example 1: Unarchive a channel The following example shows a request to unarchive a channel. #### Request
-# [HTTP](#tab/http)
<!-- { "blockType": "request",
- "name": "unarchive_channel"
+ "name": "unarchive_channel",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
}--> ```http
-POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/unarchive
+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)
--- #### Response The following example shows the response.
The following example shows the response.
}--> ```http HTTP/1.1 202 Accepted
-Location: /teams/{team-id}/operations/{operation-id}
+Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba
Content-Type: text/plain Content-Length: 0 ``` ### Example 2: Unarchive a channel when the team is archived
-The following example shows a request to unarchive a channel in an archived team.
+The following example shows a request to unarchive a channel that fails because the team is archived; the team must be active to archive or unarchive a channel.
#### Request
-<!-- { "blockType": "ignored" } -->
+<!-- {
+ "blockType": "request",
+ "name": "unarchive_channel_on_archived_team",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
+}-->
```http
-POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/unarchive
+POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/unarchive
``` #### Response
-The following example shows the `400` error response.
+The following example shows the `400 Bad Request` response code with a corresponding error message.
-<!-- { "blockType": "ignored" } -->
+<!-- {
+ "blockType": "response",
+ "name": "unarchive_channel_on_archived_team",
+ "@odata.type": "microsoft.graph.publicError",
+ "truncated": true
+}-->
```http http/1.1 400 Bad Request Content-Type: application/json
Content-Length: 193
} } }- ```+ <!-- uuid: 9a9bb83f-6f35-4426-bb04-73ca43ad6cc8 2015-10-25 14:57:30 UTC --> <!--
v1.0 Chatmessage Post Replies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-post-replies.md
POST /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |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 [message](../resources/chatmessage.md) object. Only the body property is mandatory. Other properties are optional.
v1.0 Cloudclipboarditem Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudclipboarditem-get.md
This method doesn't support the OData query parameters to customize the respone.
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Cloudclipboardroot List Items https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudclipboardroot-list-items.md
This method supports `$skipToken` [OData query parameters](/graph/query-paramete
| Name | Description | |:--|:-|
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer | odata.maxpagesize={x}. Optional. Specifies a preferred integer {x} page size for paginated results. Acceptable values are 1 to 200, inclusive. If not specified in the header, the default page size is 110. | ## Request body
v1.0 Cloudpc Bulkresize https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-bulkresize.md
Content-Type: application/json
"lastUpdatedDateTime": "2021-06-23T09:28:32.8260338Z", "cloudPcId": "30d0e128-de93-41dc-89ec-33d84bb662a0", "managedDeviceId": "bdc8e6dd-0455-4412-83d9-c818664fe1f1",
- "statusDetails": null
+ "statusDetails": null,
+ "statusDetail": null
}, { "@odata.type":"https://graph.microsoft.com/beta/$metadata#microsoft.graph.cloudPcRemoteActionResult",
Content-Type: application/json
"lastUpdatedDateTime": "2021-06-23T09:28:32.8260338Z", "cloudPcId": "7c82a3e3-9459-44e4-94d9-b92f93bf78dd", "managedDeviceId": "e87f50c7-fa7f-4687-aade-dd45f3d65970",
- "statusDetails": null
+ "statusDetails": null,
+ "statusDetail": null
} ] }
v1.0 Cloudpc Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-get.md
Content-Type: application/json
The following example shows a request.
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_cloudpc_selected_properties"
The following example shows a request.
--> ``` http
-GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/40cee9d2-03fb-4066-8d35-dbdf2875c33f?$select=id,displayName,imageDisplayName,lastModifiedDateTime,lastRemoteActionResult,lastLoginResult,connectivityResult,allotmentDisplayName
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/40cee9d2-03fb-4066-8d35-dbdf2875c33f?$select=id,displayName,imageDisplayName,lastModifiedDateTime,lastRemoteActionResult,lastLoginResult,connectivityResult,allotmentDisplayName,deviceRegionName
```
-# [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.
Content-Type: application/json
} ] },
- "allotmentDisplayName": null
+ "allotmentDisplayName": null,
+ "deviceRegionName": "eastus2"
} ```
v1.0 Cloudpc Getprovisionedcloudpcs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-getprovisionedcloudpcs.md
Content-Type: application/json
"statusDetails": null, "provisioningType": "dedicated", "allotmentDisplayName": null,
+ "deviceRegionName": "eastus2",
"connectivityResult": "", "gracePeriodEndDateTime": null, "lastLoginResult": "2020-07-23T10:29:57Z",
Content-Type: application/json
"statusDetails": null, "provisioningType": "dedicated", "allotmentDisplayName": null,
+ "deviceRegionName": "eastus2",
"connectivityResult": "", "gracePeriodEndDateTime": null, "lastLoginResult": "2020-07-23T10:29:57Z",
v1.0 Cloudpcauditevent Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcauditevent-get.md
Content-Type: application/json
"newValue": "new-adDomainUsername" } ],
- "type": "CloudPcOnPremisesConnection",
"resourceType": "CloudPcOnPremisesConnection", "resourceId": "a7508af8-d334-41ba-83a7-26cc88959724" }
v1.0 Cloudpcreports Getcloudpcrecommendationreports https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcreports-getcloudpcrecommendationreports.md
POST /deviceManagement/virtualEndpoint/reports/getCloudPcRecommendationReports
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Contact Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contact-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Contactfolder Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-delete.md
DELETE /users/{id | userPrincipalName}/contactFolders/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Contactfolder Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Contactfolder Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Contactfolder List Childfolders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-list-childfolders.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Contactfolder List Contacts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-list-contacts.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Conversation Post Threads https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/conversation-post-threads.md
POST /groups/{id}/conversations/{id}/threads
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, supply a JSON representation of the [conversationThread](../resources/conversationthread.md) object.
v1.0 Conversationmembers Add https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/conversationmembers-add.md
Namespace: microsoft.graph
Add multiple members in a single request to a [team](../resources/team.md). The response provides details about which memberships could and couldn't be created.
+> [!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.
+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions
Content-Type: application/json
#### Response
-The following is the response.
+The following example shows the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Crosstenantaccesspolicyconfigurationdefault Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/crosstenantaccesspolicyconfigurationdefault-update.md
PATCH /policies/crossTenantAccessPolicy/default
| b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your default configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the default configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. | | invitationRedemptionIdentityProviderConfiguration | [defaultInvitationRedemptionIdentityProviderConfiguration](../resources/defaultInvitationRedemptionIdentityProviderConfiguration.md) | Defines the priority order based on which an identity provider will be chosen during invitation redemption. |
-| tenantRestrictions |[crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the default tenant restrictions configuration for your organization users accessing 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. |
## Response
v1.0 Crosstenantaccesspolicyconfigurationpartner Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/crosstenantaccesspolicyconfigurationpartner-update.md
PATCH /policies/crossTenantAccessPolicy/partners/{id}
| b2bDirectConnectInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users from other organizations accessing your resources via Microsoft Entra B2B direct connect. | | b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the partner-specific configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. |
+| 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. |
## Response
HTTP/1.1 204 No Content
### Example 3: Configure tenant restrictions settings
+The following example shows how to configure tenant restrictions settings.
+ #### Request
+The following example shows a request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
PATCH https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners
Content-Type: application/json {
-"tenantRestrictions": {
- "usersAndGroups": {
- "accessType": "allowed",
- "targets": [
- {
- "target": "AllUsers",
- "targetType": "user"
- }
- ]
- },
- "applications": {
- "accessType": "allowed",
- "targets": [
- {
- "target": "Office365",
- "targetType": "application"
- }
- ]
+ "tenantRestrictions": {
+ "usersAndGroups": {
+ "accessType": "allowed",
+ "targets": [
+ {
+ "target": "AllUsers",
+ "targetType": "user"
}
+ ]
+ },
+ "applications": {
+ "accessType": "allowed",
+ "targets": [
+ {
+ "target": "Office365",
+ "targetType": "application"
+ }
+ ]
}
+ }
} ```
The following example shows the response.
``` http HTTP/1.1 204 No Content ```+
v1.0 Directory Delete Externaluserprofiles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-delete-externaluserprofiles.md
DELETE /directory/externalUserProfiles/{id}
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Directory Delete Pendingexternaluserprofiles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-delete-pendingexternaluserprofiles.md
DELETE /directory/pendingExternalUserProfiles/{id}
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Directory List Externaluserprofiles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-list-externaluserprofiles.md
For more information, see [OData query parameters](/graph/query-parameters).
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Directory List Pendingexternaluserprofile https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-list-pendingexternaluserprofile.md
This method supports the `$filter` OData query parameter to help customize the r
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Directory Post Pendingexternaluserprofile https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-post-pendingexternaluserprofile.md
POST /directory/pendingExternalUserProfiles
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Driveitem Move https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-move.md
-description: "To move a DriveItem to a new parent item, your app requests to update the parentReference of the DriveItem to move."
Previously updated : 09/10/2017 Title: Move a file or folder
+description: "Move a driveItem to a new parent folder."
+ Title: driveItem: move
ms.localizationpriority: medium doc_type: apiPageType
-# Move a DriveItem to a new folder
-
+# driveItem: move
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-To move a DriveItem to a new parent item, your app requests to update the **parentReference** of the DriveItem to move.
+Move a [driveItem](../resources/driveitem.md) to a new parent.
-This is a special case of the [Update](driveitem-update.md) method.
+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.
Your app can combine moving an item to a new container and updating other properties of the item into a single request.
-Items cannot be moved between [Drives](../resources/drive.md) using this request.
+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.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /sites/{site-id}/drive/items/{item-id}
PATCH /users/{user-id}/drive/items/{item-id} ```
-## Optional request headers
+## Request headers
| Name | Type | Description | |:--|:-|:--|
-| if-match | String | If this request header is included and the eTag (or cTag) provided does not match the current eTag on the folder, a `412 Precondition Failed` response is returned. |
+|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.|
## Request body In the request body, supply the new value for the **parentReference** property.
-Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values.
-For best performance you shouldn't include existing values that haven't changed.
+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 moving items to the root of a drive your app cannot use the `"id:" "root"` syntax.
-Your app needs to provide the actual ID of the root folder for the parent reference.
+> [!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.
## Response
-If successful, this method returns a `200 OK` response code and updated [DriveItem](../resources/driveitem.md) resource in the response body.
+If successful, this method returns a `200 OK` response code and an updated [driveItem](../resources/driveitem.md) resource in the response body.
-## Example
+For information about how errors are returned, see [Error responses][error-response].
-This example moves an item specified by {item-id} into a folder in the user's drive with the ID `new-parent-folder-id`.
+## 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`.
# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "move-item", "scopes": "files.readwrite" } -->
Content-type: application/json
} ```
-## Error responses
-
-See [Error Responses][error-response] for more info about
-how errors are returned.
- [error-response]: /graph/errors <!--
v1.0 Driveitem Post Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-post-permissions.md
+
+ 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"
+} -->
v1.0 Educationsynchronizationerrors Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationerrors-get.md
This method supports the following [OData Query Parameters](/graph/query-paramet
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationsynchronizationprofile Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-delete.md
DELETE /education/synchronizationProfiles/{id}
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-get.md
GET /education/synchronizationProfiles/{id}
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-list.md
This method supports the following [OData Query Parameters](/graph/query-paramet
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile Pause https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-pause.md
POST /education/synchronizationProfiles/{id}/pause
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-post.md
POST /education/synchronizationProfiles
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Application/json. Required. | ## Request body
v1.0 Educationsynchronizationprofile Put https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-put.md
PUT /education/synchronizationProfiles
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | ## Request body
v1.0 Educationsynchronizationprofile Reset https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-reset.md
POST /education/synchronizationProfiles/{id}/reset
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile Resume https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-resume.md
POST /education/synchronizationProfiles/{id}/resume
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile Start https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-start.md
POST /education/synchronizationProfiles/{id}/start
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile Uploadurl https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-uploadurl.md
GET /education/synchronizationProfiles/{id}/uploadUrl
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofilestatus Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofilestatus-get.md
GET /education/synchronizationProfiles/{id}/profileStatus
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Event Accept https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-accept.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Cancel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-cancel.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Decline https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-decline.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-delete.md
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Event Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-delta.md
includes the encoded, desired parameters.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. | | Prefer | string | outlook.timezone={Time zone string}. Optional, UTC assumed if absent.|
v1.0 Event Dismissreminder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-dismissreminder.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Response
v1.0 Event Forward https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-forward.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header isn't specified, the **body** property is returned in HTML format. Optional. |
v1.0 Event List Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-list-attachments.md
GET https://graph.microsoft.com/beta/me/events/{id}?$expand=attachments
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Event List Instances https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-list-instances.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | ## Request body
v1.0 Event Post Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-post-attachments.md
POST /groups/{id}/events/{id}/attachments
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Snoozereminder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-snoozereminder.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Tentativelyaccept https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-tentativelyaccept.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-update.md
PATCH /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.
v1.0 Eventmessage Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-delete.md
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Eventmessage Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Eventmessage List Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-list-attachments.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Eventmessage Post Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-post-attachments.md
POST /users/{id|userPrincipalName}/messages/{id}/attachments
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Eventmessage Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-update.md
PATCH /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed. Writable/Updatable properties are
v1.0 Externaluserprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externaluserprofile-get.md
GET /directory/externalUserProfiles/{id}
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Externaluserprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externaluserprofile-update.md
PATCH /directory/externalUserProfiles/{id}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Group Deletepasswordsinglesignoncredentials https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-deletepasswordsinglesignoncredentials.md
POST /groups/{groupsId}/deletePasswordSingleSignOnCredentials
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Group Get Event https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-get-event.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description | | :-- | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header isn't specified, the **body** property is returned in HTML format. Optional. |
v1.0 Group Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-get.md
For more information on OData query options, see [OData Query Parameters](/graph
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Getpasswordsinglesignoncredentials https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-getpasswordsinglesignoncredentials.md
POST /groups/{groupsId}/getPasswordSingleSignOnCredentials
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-list-calendarview.md
This method also supports some of the [OData Query Parameters](/graph/query-para
| Name | Type | Description | | :-- | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header isn't specified, the **body** property is returned in HTML format. Optional. |
v1.0 Group List Events https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-list-events.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this header to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header is not specified, the **body** property is returned in HTML format. Optional. |
v1.0 Group List Owners https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-list-owners.md
Some queries are supported only when you use the **ConsistencyLevel** header set
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group List Photos https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-list-photos.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Update Event https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-update-event.md
PATCH /groups/{id}/calendar/events/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Update Thread https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-update-thread.md
PATCH /groups/{id}/threads/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-update.md
PATCH /groups/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Upsert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-upsert.md
PATCH /groups/(uniqueName='uniqueName')
| Name | Description | |:--|:|
-| Authorization | Bearer {token}. Required.|
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required.| | Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. |
v1.0 Industrydata Administrativeunitprovisioningflow Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-administrativeunitprovisioningflow-delete.md
DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlow
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Administrativeunitprovisioningflow Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-administrativeunitprovisioningflow-get.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Administrativeunitprovisioningflow Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-administrativeunitprovisioningflow-update.md
PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Classgroupprovisioningflow Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-classgroupprovisioningflow-delete.md
DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlow
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Classgroupprovisioningflow Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-classgroupprovisioningflow-get.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Classgroupprovisioningflow Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-classgroupprovisioningflow-update.md
PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Industrydataroot Delete Outboundprovisioningflowsets https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-industrydataroot-delete-outboundprovisioningflowsets.md
DELETE /external/industryData/outboundProvisioningFlowSets/{id}
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Industrydataroot List Outboundprovisioningflowsets https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-industrydataroot-list-outboundprovisioningflowsets.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Industrydataroot Post Outboundprovisioningflowsets https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-industrydataroot-post-outboundprovisioningflowsets.md
POST /external/industryData/OutboundProvisioningFlowSets
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Outboundprovisioningflowset Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-get.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Outboundprovisioningflowset List Provisioningflows https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-list-provisioningflows.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Outboundprovisioningflowset Post Provisioningflows https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-post-provisioningflows.md
POST /external/industryData/outboundProvisioningFlowSets/{id}/provisioningFlows
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Outboundprovisioningflowset Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-update.md
PATCH /external/industryData/outboundProvisioningFlowSets/{id}
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Provisioningflow Reset https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-provisioningflow-reset.md
POST /external/industryData/outboundProvisioningFlowSets/{outboundProvisioningFl
| Name | Description | | :-- | : |
-| Authorization| Bearer {token}. Required. |
+| Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Securitygroupprovisioningflow Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-securitygroupprovisioningflow-delete.md
DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlow
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Securitygroupprovisioningflow Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-securitygroupprovisioningflow-get.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Securitygroupprovisioningflow Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-securitygroupprovisioningflow-update.md
PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Userprovisioningflow Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-userprovisioningflow-delete.md
DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlow
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Userprovisioningflow Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-userprovisioningflow-get.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Userprovisioningflow Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-userprovisioningflow-update.md
PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Inferenceclassification List Overrides https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inferenceclassification-list-overrides.md
GET /users/{id}/inferenceClassification/overrides
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Inferenceclassification Post Overrides https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inferenceclassification-post-overrides.md
POST /users/{id}/inferenceClassification/overrides
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Inferenceclassificationoverride Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inferenceclassificationoverride-delete.md
DELETE /users/{id}/inferenceClassification/overrides/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Inferenceclassificationoverride Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inferenceclassificationoverride-update.md
PATCH /users/{id}/inferenceClassification/overrides/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 List Delete Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-delete-permissions.md
+
+ 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"
+} -->
v1.0 List Get Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-get-permissions.md
+
+ 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"
+} -->
v1.0 List List Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-list-permissions.md
+
+ 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"
+} -->
v1.0 List Post Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-post-permissions.md
+
+ 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"
+} -->
v1.0 List Update Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-update-permissions.md
+
+ 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"
+} -->
v1.0 Listitem Delete Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-delete-permissions.md
+
+ 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"
+} -->
v1.0 Listitem Get Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-get-permissions.md
+
+ 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"
+} -->
v1.0 Listitem List Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-list-permissions.md
+
+ 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"
+} -->
v1.0 Listitem Post Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-post-permissions.md
+
+ 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"
+} -->
v1.0 Listitem Update Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-update-permissions.md
+
+ 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"
+} -->
v1.0 Mailfolder Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mailfolder-delete.md
DELETE /users/{id | userPrincipalName}/mailFolders/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Mailfolder Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mailfolder-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Mailfolder List Childfolders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mailfolder-list-childfolders.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description | |:--|:-|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Mailfolder List Messagerules https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mailfolder-list-messagerules.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Mailfolder List Messages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mailfolder-list-messages.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Message Createforward https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-createforward.md
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/createForwar
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required.|
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content.| ## Request body
v1.0 Message Createreply https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-createreply.md
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/createReply
## Request headers | Name | Type | Description| |:|:--|:-
-| Authorization | string | Bearer {token}. Required.|
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content.| | Prefer: outlook.timezone | string | Sets the time zone for the `Sent` field of the reply draft message in HTML that this API creates based on the request body. The value can be any of the [supportedTimeZones](outlookuser-supportedtimezones.md) configured for the user. If not specified, that `Sent` field is in UTC.<br><br> Use this header only if you're specifying the `Content-Type: application/json` header to create the reply draft message in HTML. If you use the `Content-Type: text/plain` header, this `Prefer` header does not have any effect. Optional.|
v1.0 Message Createreplyall https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-createreplyall.md
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/createReplyA
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content. | | Prefer: outlook.timezone | string | Sets the time zone for the `Sent` field of the reply draft message in HTML that this API creates based on the request body. The value can be any of the [supportedTimeZones](outlookuser-supportedtimezones.md) configured for the user. If not specified, that `Sent` field is in UTC.<br><br> Use this header only if you're specifying the `Content-Type: application/json` header to create the reply draft message in HTML. If you use the `Content-Type: text/plain` header, this `Prefer` header does not have any effect. Optional.|
v1.0 Message Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-delete.md
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/mentions/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Message Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Message Forward https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-forward.md
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/forward
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content. | ## Request body
v1.0 Message Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-get.md
of each [mention](../resources/mention.md) in the message expanded.
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.body-content-type | string | The format of the **body** and **uniqueBody** properties to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header is not specified, the **body** and **uniqueBody** properties are returned in HTML format. Optional. | ## Request body
v1.0 Message List Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-list-attachments.md
GET https://graph.microsoft.com/beta/me/messages/{id}?$expand=attachments
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Message Post Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-post-attachments.md
POST /users/{id | userPrincipalName}/mailFolders/{id}/childFolders/{id}/messages
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Message Send https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-send.md
POST /users/{id | userPrincipalName}/messages/{id}/send
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Length | number | 0. Required. | ## Request body
v1.0 Message Unsubscribe https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-unsubscribe.md
POST /users/{id | userPrincipalName}/messages/{id}/unsubscribe
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Message Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-update.md
PATCH /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Networkaccess Connectivity Delete Remotenetworks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-delete-remotenetworks.md
DELETE /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/$ref
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Networkaccess Connectivity List Remotenetworks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-list-remotenetworks.md
This method supports the `$expand` and `$select` OData query parameters to help
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Networkaccess Connectivity Post Remotenetworks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-post-remotenetworks.md
POST /networkAccess/connectivity/remoteNetworks
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Networkaccess Devicelink Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-devicelink-delete.md
DELETE /networkAccess/connectivity/remotenetworks/{remoteNetworkId}/deviceLinks/
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Networkaccess Remotenetwork Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-get.md
This method supports the `$expand` and `$select` OData query parameter to help c
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Networkaccess Remotenetwork List Devicelinks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-list-devicelinks.md
This method supports the `$expand` [OData query parameter](/graph/query-paramete
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Networkaccess Remotenetwork List Forwardingprofiles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-list-forwardingprofiles.md
This method does not support any OData query parameters.
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Networkaccess Remotenetwork Post Devicelinks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-post-devicelinks.md
POST /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/deviceLinks
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Networkaccess Remotenetwork Post Forwardingprofiles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-post-forwardingprofiles.md
PATCH /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/forwardingPro
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Networkaccess Remotenetwork Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetwork-update.md
PATCH /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Networkaccess Remotenetworkconnectivityconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-remotenetworkconnectivityconfiguration-get.md
This method does not supports OData query parameters.
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Notebook Copynotebook https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/notebook-copynotebook.md
POST /sites/{id}/onenote/notebooks/{id}/copyNotebook
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Notebook Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/notebook-get.md
Valid `expand` values for notebooks are `sections` and `sectionGroups`.
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Notebook Getnotebookfromweburl https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/notebook-getnotebookfromweburl.md
POST /sites/{id}/onenote/notebooks/GetNotebookFromWebUrl
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Notebook List Sectiongroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/notebook-list-sectiongroups.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Notebook List Sections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/notebook-list-sections.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Notebook Post Sectiongroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/notebook-post-sectiongroups.md
POST /sites/{id}/onenote/notebooks/{id}/sectionGroups
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Notebook Post Sections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/notebook-post-sections.md
POST /sites/{id}/onenote/notebooks/{id}/sections
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Oauth2permissiongrant Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/oauth2permissiongrant-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Oauth2permissiongrant Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/oauth2permissiongrant-post.md
POST /oauth2PermissionGrants
| Name | Type | Description | |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Oauth2permissiongrant Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/oauth2permissiongrant-update.md
PATCH /oauth2PermissionGrants/{id}
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Onenote List Notebooks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onenote-list-notebooks.md
Valid `expand` values for notebooks are `sections` and `sectionGroups`.
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Onenote List Pages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onenote-list-pages.md
The default response expands `parentSection` and selects the section's `id`, `di
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Onenote List Sectiongroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onenote-list-sectiongroups.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Onenote List Sections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onenote-list-sections.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Onenote Post Notebooks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onenote-post-notebooks.md
POST /sites/{id}/onenote/notebooks
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Onenote Post Pages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onenote-post-pages.md
POST /sites/{id}/onenote/pages
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `text/html` or `application/xhtml+xml` for the HTML content, including for the required "Presentation" part of multipart requests. Multipart requests use the `multipart/form-data; boundary=your-boundary` content type. | ## Request body
v1.0 Onenoteoperation Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onenoteoperation-get.md
None.
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Organization List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/organization-list.md
This method supports the `$select` [OData query parameter](/graph/query-paramete
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Orgcontact Get Manager https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/orgcontact-get-manager.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Orgcontact Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/orgcontact-get.md
This method supports the `$select` and `$expand` [OData query parameters](/graph
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Orgcontact List Directreports https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/orgcontact-list-directreports.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Orgcontact List Memberof https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/orgcontact-list-memberof.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Outlookuser Supportedlanguages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/outlookuser-supportedlanguages.md
GET /users/{id|userPrincipalName}/outlook/supportedLanguages
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Outlookuser Supportedtimezones https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/outlookuser-supportedtimezones.md
GET /users/{id|userPrincipalName}/outlook/supportedTimeZones(TimeZoneStandard=mi
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Page Copytosection https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/page-copytosection.md
POST /sites/{id}/onenote/pages/{id}/copyToSection
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json | ## Request body
v1.0 Page Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/page-delete.md
DELETE /sites/{id}/onenote/pages/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Response
v1.0 Page Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/page-get.md
The default response expands `parentSection` and selects the section's `id`, `na
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Page Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/page-update.md
PATCH /sites/{id}/onenote/pages/{id}/content
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Partners Billing Billedreconciliation Export https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/partners-billing-billedreconciliation-export.md
POST /reports/partners/billing/reconciliation/billed/export
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Pendingexternaluserprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/pendingexternaluserprofile-get.md
GET /directory/pendingExternalUserProfiles/{id}
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Pendingexternaluserprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/pendingexternaluserprofile-update.md
PATCH /directory/pendingExternalUserProfiles/{id}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Peopleadminsettings List Iteminsights https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/peopleadminsettings-list-iteminsights.md
GET /admin/people/itemInsights
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Profilephoto Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/profilephoto-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Projectrome Delete Activity https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/projectrome-delete-activity.md
DELETE /me/activities/{id}
|Name | Type | Description| |:-|:--|:--|
-|Authorization | string | Bearer {token}. Required.|
+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Projectrome Delete Historyitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/projectrome-delete-historyitem.md
DELETE /me/activities/{id}/historyItems/{id}
|Name | Type | Description| |:-|:--|:--|
-|Authorization | string | Bearer {token}. Required.|
+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Projectrome Get Activities https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/projectrome-get-activities.md
The following are some examples of supported queries with URL encoding:
|Name | Type | Description| |:-|:--|:--|
-|Authorization | string | Bearer {token}. Required.|
+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Projectrome Get Recent Activities https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/projectrome-get-recent-activities.md
The following are some examples of supported queries with URL encoding.
|Name | Type | Description| |:-|:--|:--|
-|Authorization | string | Bearer {token}. Required.|
+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Projectrome Put Activity https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/projectrome-put-activity.md
PUT /me/activities/{appActivityId}
| Name | Type | Description | |:--|:-|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Projectrome Put Historyitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/projectrome-put-historyitem.md
PUT /me/activities/{id}/historyItems/{id}
|Name | Type | Description| |:-|:--|:--|
-|Authorization | string | Bearer {token}. Required.|
+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Reportroot Getrelyingpartydetailedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/reportroot-getrelyingpartydetailedsummary.md
This method supports the `$filter` and `$orderby` OData query parameters to help
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Resource Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/resource-get.md
GET /sites/{id}/onenote/resources/{id}/content
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Section Copytonotebook https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/section-copytonotebook.md
POST /sites/{id}/onenote/sections/{id}/copyToNotebook
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Section Copytosectiongroup https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/section-copytosectiongroup.md
POST /sites/{id}/onenote/sections/{id}/copyToSectionGroup
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Section Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/section-get.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Section List Pages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/section-list-pages.md
The default response expands `parentSection` and selects the section's `id`, `na
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Section Post Pages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/section-post-pages.md
POST /sites/{id}/onenote/sections/{id}/pages
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `text/html` or `application/xhtml+xml` for the HTML content, including for the required "Presentation" part of multipart requests. Multipart requests use the `multipart/form-data; boundary=your-boundary` content type. | ## Request body
v1.0 Sectiongroup Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sectiongroup-get.md
The default query expands `parentNotebook` and selects its `id`, `name`, and `se
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Sectiongroup List Sectiongroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sectiongroup-list-sectiongroups.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Sectiongroup List Sections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sectiongroup-list-sections.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Sectiongroup Post Sectiongroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sectiongroup-post-sectiongroups.md
POST /sites/{id}/onenote/sectionGroups/{id}/sectionGroups
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Sectiongroup Post Sections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sectiongroup-post-sections.md
POST /sites/{id}/onenote/sectionGroups/{id}/sections
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Security Auditcoreroot List Auditlogqueries https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-auditcoreroot-list-auditlogqueries.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Auditcoreroot Post Auditlogqueries https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-auditcoreroot-post-auditlogqueries.md
POST /security/auditLog/queries
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Security Auditlogquery Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-auditlogquery-get.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Auditlogquery List Records https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-auditlogquery-list-records.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Security Collaborationroot List Analyzedemails https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-collaborationroot-list-analyzedemails.md
GET /security/collaboration/analyzedemails?startTime=2024-02-18&endTime=2024-02-
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Security Detectionrule Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-detectionrule-delete.md
DELETE /security/rules/detectionRules/{ruleId}
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Detectionrule Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-detectionrule-get.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Detectionrule List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-detectionrule-list.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Detectionrule Post Detectionrules https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-detectionrule-post-detectionrules.md
POST /security/rules/detectionRules
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Security Detectionrule Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-detectionrule-update.md
PATCH /security/rules/detectionRules/{ruleId}
## Request headers | Name | Description | |:--|:-|
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Serviceprincipal List Memberof https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-memberof.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| ConsistencyLevel | eventual. This header and `$count` are required when using the `$search`, `$filter`, `$orderby`, or OData cast query parameters. It uses an index that might not be up-to-date with recent changes to the object. | ## Request body
v1.0 Serviceprincipal List Transitivememberof https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-transitivememberof.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| ConsistencyLevel | eventual. This header and `$count` are required when using the `$search`, `$filter`, `$orderby`, or OData cast query parameters. It uses an index that might not be up-to-date with recent changes to the object. | ## Request body
v1.0 Serviceprincipal Upsert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-upsert.md
PATCH /servicePrincipals(appId='appId')
## Request headers | Name | Description| |:--|:-|
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | | Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. |
v1.0 Shiftsroledefinition Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/shiftsroledefinition-get.md
This method doesn't support OData query parameters to customize the response.
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| MS-APP-ACTS-AS | A user ID (GUID). Required only if the authorization token is an application token; otherwise, optional. | ## Request body
v1.0 Shiftsroledefinition Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/shiftsroledefinition-update.md
PATCH /team/{teamId}/schedule/shiftsRoleDefinitions/{roleId}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| | MS-APP-ACTS-AS | A user ID (GUID). Required only if the authorization token is an application token; otherwise, optional. |
v1.0 Site Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/site-delta.md
This method also supports the `$select`, `$expand`, and `$top` [OData query para
|Header |Value | |-|-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Subscription Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/subscription-delete.md
DELETE /subscriptions/{subscription-id}
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Subscription Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/subscription-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description| |:--|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Subscription List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/subscription-list.md
Most commonly, an application wants to retrieve subscriptions that it originally
### Advanced scenarios
-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, an administrator who wants to see all subscriptions from all apps in their directory.
+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.
For such scenarios, a delegated permission Subscription.Read.All is required. | Context of the calling app | Response contains | |:--|:- | | App is calling on behalf of the signed-in user (delegated permission). *The user is a non-admin*. <br/>-and-<br/>App has the permission Subscription.Read.All<br/><br/>Note: This scenario applies to both personal Microsoft accounts and work/school accounts. | Subscriptions created by **any app** for the signed-in user only. |
-| App is calling on behalf of the signed-in user (delegated permission). *The user is an admin*.<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.|
+| 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.|
## HTTP request
This method doesn't support the [OData query parameters](/graph/query-parameters
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Subscription Post Subscriptions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/subscription-post-subscriptions.md
POST /subscriptions
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Subscription Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/subscription-update.md
PATCH /subscriptions/{id}
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronization List Jobs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronization-list-jobs.md
GET /servicePrincipals/{id}/synchronization/jobs/
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronization List Templates https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronization-list-templates.md
GET /applications/{id}/synchronization/templates
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronization Post Jobs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronization-post-jobs.md
POST /servicePrincipals/{id}/synchronization/jobs/
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationjob Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationjob-delete.md
DELETE /servicePrincipals/{id}/synchronization/jobs/{jobId}/
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationjob Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationjob-get.md
GET /servicePrincipals/{id}/synchronization/jobs/{jobId}/
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationjob Pause https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationjob-pause.md
POST /servicePrincipals/{id}/synchronization/jobs/{jobId}/pause
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationjob Restart https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationjob-restart.md
POST /servicePrincipals(appId='{appId}')/synchronization/jobs/{jobId}/restart
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationjob Start https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationjob-start.md
POST /servicePrincipals/{id}/synchronization/jobs/{jobId}/start
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationschema Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationschema-delete.md
DELETE /applications/{id}/synchronization/templates/{templateId}/schema
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationschema Filteroperators https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationschema-filteroperators.md
GET /applications/{id}/synchronization/templates/{templateId}/schema/filterOpera
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationschema Functions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationschema-functions.md
GET /applications/{id}/synchronization/templates/{templateId}/schema/functions
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationschema Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationschema-get.md
GET /applications/{id}/synchronization/templates/{templateId}/schema
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationschema Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationschema-update.md
PUT /applications/{id}/synchronization/templates/{templateId}/schema
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationtemplate-get.md
GET /servicePrincipals/{id}/synchronization/templates/{templateId}
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationtemplate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationtemplate-update.md
PATCH /applications/{id}/synchronization/templates/{templateId}
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Team Getshifts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-getshifts.md
This method supports the `$top` and `$filter` [OData query parameters](/graph/qu
|Name|Description| |:|:|
-| Authorization|Bearer {token}. Required.|
+| Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| MS-APP-ACTS-AS | A user ID (GUID). Required only if the authorization token is an application token; otherwise, optional. | ## Request body
v1.0 Team Gettimesoff https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-gettimesoff.md
This method supports the `$top`, `$orderby`, `$select` and `$filter` [OData quer
|Name|Description| |:|:|
-| Authorization|Bearer {token}. Required.|
+| Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| MS-APP-ACTS-AS | A user ID (GUID). Required only if the authorization token is an application token; otherwise, optional. | ## Request body
v1.0 Team Post Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-post-members.md
Namespace: microsoft.graph
Add a new [conversation member](../resources/conversationmember.md) to a [team](../resources/team.md). > [!NOTE]
-> The **roles** property will be 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 should not have any values specified in the **roles** property.
+> * 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.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
In the request body, supply a JSON representation of the [conversationMember](..
If successful, this method returns a `201 Created` response code and a [conversationMember](../resources/conversationmember.md) object in the response body. For best results, stagger calls with 2 seconds of buffer.
-For best results, stagger calls with a 2 second buffer.
+For best results, stagger calls with a 2-second buffer.
> [!NOTE] > The response code `404 Not Found` is returned when you attempt to add a disabled/blocked user.
v1.0 Todotask Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/todotask-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Todotasklist Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/todotasklist-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 User Convertexternaltointernalmemberuser https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-convertexternaltointernalmemberuser.md
POST /users/{usersId}/convertExternalToInternalMemberUser
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 User Deletepasswordsinglesignoncredentials https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-deletepasswordsinglesignoncredentials.md
POST /users/{usersId}/deletePasswordSingleSignOnCredentials
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 User Findroomlists https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-findroomlists.md
GET /users/{id}/findRoomLists
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. |
v1.0 User Findrooms https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-findrooms.md
GET /users/{id}/findRooms(RoomList='{room_list_emailAddress}')
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. |
v1.0 User Get Mailboxsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-get-mailboxsettings.md
This method supports some of the [OData Query Parameters](/graph/query-parameter
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 User Getpasswordsinglesignoncredentials https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-getpasswordsinglesignoncredentials.md
POST /users/{usersId}/getPasswordSingleSignOnCredentials
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 User List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-calendarview.md
This method also supports some of the [OData Query Parameters](/graph/query-para
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header isn't specified, the **body** property is returned in HTML format. Optional. |
v1.0 User List Events https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-events.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header is not specified, the **body** property is returned in HTML format. Optional. |
v1.0 User List Messages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-messages.md
Failing to do this results in the following error:
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.body-content-type | string | The format of the **body** and **uniqueBody** properties to be returned in. Values can be "text" or "html". If the header is not specified, the **body** and **uniqueBody** properties are returned in HTML format. Optional. | ## Request body
v1.0 User Sendmail https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-sendmail.md
POST /users/{id | userPrincipalName}/sendMail
| Name | Type | Description| |:|:--|:-
-| Authorization | string | Bearer {token}. Required.|
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content.| ## Request body
v1.0 User Update Mailboxsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-update-mailboxsettings.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, supply the values for the relevant properties that should be updated. Existing properties that are not included in the
v1.0 Virtualendpoint List Auditevents https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualendpoint-list-auditevents.md
Content-Type: application/json
"newValue": "new-adDomainUsername" } ],
- "type": "CloudPcOnPremisesConnection",
"resourceType": "CloudPcOnPremisesConnection", "resourceId": "a7508af8-d334-41ba-83a7-26cc88959724" }
v1.0 Virtualendpoint List Cloudpcs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualendpoint-list-cloudpcs.md
Content-Type: application/json
"statusDetails": null, "gracePeriodEndDateTime": "2020-11-010T20:00:34Z", "provisioningType": "dedicated",
+ "deviceRegionName": "eastus2",
"diskEncryptionState": "encryptedUsingPlatformManagedKey" } ]
Content-Type: application/json
"servicePlanType": "enterprise", "diskEncryptionState": "notAvailable", "provisioningType": "dedicated",
+ "deviceRegionName": "eastus2",
"statusDetails": { "code": "intuneEnrollFailed", "message": "We can’t complete MEM enrollment of this Cloud PC. Check MEM policy settings and retry. If that doesn’t work, contact Customer support.",
Content-Type: application/json
"servicePlanType": "enterprise", "diskEncryptionState": "notAvailable", "provisioningType": "dedicated",
+ "deviceRegionName": "eastus2",
"statusDetails": { "code": "intuneEnrollFailed", "message": "We can’t complete MEM enrollment of this Cloud PC. Check MEM policy settings and retry. If that doesn’t work, contact Customer support.",
v1.0 Virtualevent List Presenters https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualevent-list-presenters.md
GET /solutions/virtualEvents/webinars/{webinarId}/presenters
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Virtualevent Post Presenters https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualevent-post-presenters.md
POST /solutions/virtualEvents/webinars/{webinarId}/presenters
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Virtualeventpresenter Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventpresenter-delete.md
DELETE /solutions/virtualEvents/webinars/{webinarId}/presenters/{presenterId}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Virtualeventpresenter Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventpresenter-get.md
GET /solutions/virtualEvents/webinars/{webinarId}/presenters/{presenterId}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Virtualeventregistration Cancel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistration-cancel.md
+
+ Title: "virtualEventRegistration: cancel"
+description: "Cancel a registrant's registration record for a webinar."
+
+ms.localizationpriority: medium
+++
+# virtualEventRegistration: cancel
+Namespace: microsoft.graph
++
+Cancel a registrant's [registration record](../resources/virtualeventregistration.md) for a [webinar](../resources/virtualeventwebinar.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+<!-- {
+ "blockType": "permissions",
+ "name": "virtualeventregistration-cancel-permissions"
+}
+-->
+
+> [!NOTE]
+> - Use delegated permissions to cancel a registration record for a person who has a [Microsoft Entra ID](https://learn.microsoft.com/entra/fundamentals/whatis).
+> - Use application permissions to cancel a registration record for an anonymous user.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /solutions/virtualEvents/webinars/{webinarId}/registrations/{registrationId}/cancel
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "virtualeventregistrationthis.cancel"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations/127962bb-84e1-7b62-fd98-1c9d39def7b6/cancel
+```
++
+### Response
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Virtualeventregistration List Sessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistration-list-sessions.md
+
+ Title: "List sessions"
+description: "Get a list of sessions that a registrant registered for in a webinar."
+
+ms.localizationpriority: medium
+++
+# List sessions
+Namespace: microsoft.graph
++
+Get a list of [sessions](../resources/virtualeventsession.md) that a registrant registered for in a [webinar](../resources/virtualeventwebinar.md).
+
+> [!NOTE]
+>
+> Currently, this API only supports single session webinars and returns a single session.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+<!-- {
+ "blockType": "permissions",
+ "name": "virtualeventregistration-list-sessions-permissions"
+}
+-->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /solutions/virtualEvents/webinars/{webinarId}/registrations/{registrationId}/sessions
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [virtualEventSession](../resources/virtualeventsession.md) objects in the response body.
+
+> [!NOTE]
+>
+> Currently, this API is only able to return the session summary, which is a partial representation of the full session object.
+
+## Examples
+
+### Request
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "list_virtualeventregistrationsessions"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations/127962bb-84e1-7b62-fd98-1c9d39def7b6/sessions
+```
++
+### Response
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.virtualEventSession)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.virtualEventSession",
+ "id": "8d62dd52-4dff-4c75-96a9-f905cc3ff942",
+ "startDateTime": "2023-08-08T12:30:00Z",
+ "endDateTime": "2023-08-09T22:00:00Z",
+ "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_ZDVjNzk3OWEtYjc2NS00NTA1LTkyMzQtYTYzMGI5YmFmMjM5%40thread.v2/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%221cd068e4-5b08-4e75-a7f9-7b4e067a0820%22%7d",
+ "subject": "Session one",
+ "isBroadcast": null,
+ "broadcastSettings": null,
+ "capabilities": [],
+ "audioConferencing": null,
+ "chatInfo": null,
+ "videoTeleconferenceId": null,
+ "externalId": null,
+ "joinMeetingIdSettings": null,
+ "lobbyBypassSettings": null,
+ "isEntryExitAnnounced": null,
+ "allowedPresenters": null,
+ "allowAttendeeToEnableMic": null,
+ "allowAttendeeToEnableCamera": null,
+ "allowMeetingChat": null,
+ "shareMeetingChatHistoryDefault": null,
+ "allowTeamworkReactions": null,
+ "recordAutomatically": null,
+ "watermarkProtection": null,
+ "allowParticipantsToChangeName": null
+ }
+ ]
+}
+```
v1.0 Virtualeventregistration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistration-list.md
Title: "List virtualEventRegistrations" description: "Get a list of all registration records of a webinar."-+ ms.localizationpriority: medium doc_type: apiPageType
Choose the permission or permissions marked as least privileged for this API. Us
--> ``` http GET /solutions/virtualEvents/webinars/{webinarId}/registrations
+GET /solutions/virtualEvents/webinars/{webinarId}/registrations?$filter=userId eq '{userId}'
+GET /solutions/virtualEvents/webinars/{webinarId}/registrations?$filter=email eq '{email}'
```- ## 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).
+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.|
## Request headers
Don't supply a request body for this method.
## Response If successful, this method returns a `200 OK` response code and a collection of [virtualEventRegistration](../resources/virtualeventregistration.md) objects in the response body.
+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.
## Examples
-### Request
+### Example 1: Retrieve a list of virtual event registrations
+
+#### Request
The following example shows a request.
GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-5
-### Response
+#### Response
The following example shows the response.
Content-Type: application/json
"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 2: Retrieve a virtual event registration by user ID
+
+#### Request
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "virtualeventregistration-get-byuserid"
+}
+-->
+```http
+GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations?$filter=userId eq 'b7ef013a-c73c-4ec7-8ccb-e56290f45f68'
+```
+
+#### Response
+
+The following example shows the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.virtualEventRegistration)"
+} -->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.virtualEventRegistration",
+ "id": "127962bb-84e1-7b62-fd98-1c9d39def7b6",
+ "userId": "String",
+ "firstName": "Emilee",
+ "lastName": "Pham",
+ "email": "EmileeMPham@contoso.com",
+ "status": "registered",
+ "registrationDateTime": "2023-03-07T22:04:17",
+ "cancelationDateTime": null,
+ "preferredTimezone":"Pacific Standard Time",
+ "preferredLanguage":"en-us",
+ "registrationQuestionAnswers": [
+ {
+ "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
+ "displayName": "Which city do you currently work in?",
+ "value": null,
+ "booleanValue": null,
+ "multiChoiceValues": [
+ "Seattle"
+ ]
+ },
+ {
+ "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",
+ "displayName": "Do you in the same city where you work?",
+ "value": null,
+ "booleanValue": true,
+ "multiChoiceValues": []
+ },
+ {
+ "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",
+ "displayName": "Which cities have you worked in?",
+ "value": null,
+ "booleanValue": null,
+ "multiChoiceValues": [
+ "Cancun",
+ "Hoboken",
+ "Beijing"
+ ]
+ }
+ ]
+ }
+ ]
+}
+```
+
+### Example 3: Retrieve a virtual event registration by email
+
+#### Request
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "virtualeventregistration-get-byemail"
+}
+-->
+```http
+GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations?$filter=email eq 'EmileeMPham@contoso.com'
+```
+
+#### Response
+
+The following example shows the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.virtualEventRegistration)"
+} -->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.virtualEventRegistration",
+ "id": "127962bb-84e1-7b62-fd98-1c9d39def7b6",
+ "userId": "String",
+ "firstName": "Emilee",
+ "lastName": "Pham",
+ "email": "EmileeMPham@contoso.com",
+ "status": "registered",
+ "registrationDateTime": "2023-03-07T22:04:17",
+ "cancelationDateTime": null,
+ "preferredTimezone":"Pacific Standard Time",
+ "preferredLanguage":"en-us",
"registrationQuestionAnswers": [ { "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
v1.0 Virtualeventregistration Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistration-post.md
+
+ Title: "Create virtualEventRegistration"
+description: "Create a registration record for a webinar registrant."
+
+ms.localizationpriority: medium
+++
+# Create virtualEventRegistration
+Namespace: microsoft.graph
++
+Create a [registration record](../resources/virtualeventregistration.md) for a registrant of a [webinar](../resources/virtualeventwebinar.md). This method registers the person for the webinar.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+<!-- {
+ "blockType": "permissions",
+ "name": "virtualeventregistration-post-permissions"
+}
+-->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /solutions/virtualEvents/webinars/{webinarId}/registrations
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+In the request body, supply a JSON representation of a [virtualEventRegistration](../resources/virtualeventregistration.md) object.
+
+## Response
+
+If successful, this action returns one of the following:
+* A `201 Created` response code and [virtualEventRegistration](../resources/virtualeventregistration.md) object for delegated permissions.
+* A `204 No Content` response code for application permissions.
+
+## Examples
+
+### Example 1: Creating registration record with delegated permission
+
+Use delegated permission to create a registration record for a person who has a [Microsoft Entra ID](https://learn.microsoft.com/entra/fundamentals/whatis) as a way to register a Microsoft Entra user to a webinar.
+
+#### Request
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "create-virtualeventregistration-delegated",
+ "@odata.type": "microsoft.graph.virtualEventRegistration"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations
+Content-Type: application/json
+
+{
+ "preferredTimezone":"Pacific Standard Time",
+ "preferredLanguage":"en-us",
+ "registrationQuestionAnswers": [
+ {
+ "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
+ "value": null,
+ "booleanValue": null,
+ "multiChoiceValues": [
+ "Seattle"
+ ]
+ },
+ {
+ "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",
+ "value": null,
+ "booleanValue": true,
+ "multiChoiceValues": []
+ },
+ {
+ "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",
+ "value": null,
+ "booleanValue": null,
+ "multiChoiceValues": [
+ "Cancun",
+ "Hoboken",
+ "Beijing"
+ ]
+ }
+ ]
+}
+```
+
+#### Response
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.virtualEventRegistration"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.virtualEventRegistration",
+ "id": "127962bb-84e1-7b62-fd98-1c9d39def7b6",
+ "userId": "String",
+ "firstName": "Emilee",
+ "lastName": "Pham",
+ "email": "EmileeMPham@contoso.com",
+ "status": "registered",
+ "registrationDateTime": "2023-03-07T22:04:17",
+ "cancelationDateTime": null,
+ "preferredTimezone":"Pacific Standard Time",
+ "preferredLanguage":"en-us",
+ "registrationQuestionAnswers": [
+ {
+ "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
+ "displayName": "Which city do you currently work in?",
+ "value": null,
+ "booleanValue": null,
+ "multiChoiceValues": [
+ "Seattle"
+ ]
+ },
+ {
+ "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",
+ "displayName": "Do you live in the same city where you work?",
+ "value": null,
+ "booleanValue": true,
+ "multiChoiceValues": []
+ },
+ {
+ "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",
+ "displayName": "Which cities have you worked in?",
+ "value": null,
+ "booleanValue": null,
+ "multiChoiceValues": [
+ "Cancun",
+ "Hoboken",
+ "Beijing"
+ ]
+ }
+ ]
+}
+```
+
+### Example 2: Creating registration record with application permission
+
+Use application permission to create a registration record for a person who does not have a [Microsoft Entra ID](https://learn.microsoft.com/entra/fundamentals/whatis) as a way to register an anonymous user for a webinar.
+
+#### Request
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "create-virtualeventregistration-application",
+ "@odata.type": "microsoft.graph.virtualEventRegistration"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations
+Content-Type: application/json
+
+{
+ "firstName" : "Diane",
+ "lastName" : "Demoss",
+ "email" : "DianeDemoss@contoso.com",
+ "preferredTimezone":"Pacific Standard Time",
+ "preferredLanguage":"en-us",
+ "registrationQuestionAnswers": [
+ {
+ "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
+ "value": null,
+ "booleanValue": null,
+ "multiChoiceValues": [
+ "Seattle"
+ ]
+ },
+ {
+ "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",
+ "value": null,
+ "booleanValue": true,
+ "multiChoiceValues": []
+ },
+ {
+ "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",
+ "value": null,
+ "booleanValue": null,
+ "multiChoiceValues": [
+ "London",
+ "New York City"
+ ]
+ }
+ ]
+}
+```
+
+#### Response
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Virtualeventregistrationconfiguration List Questions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistrationconfiguration-list-questions.md
+
+ Title: "List questions"
+description: "Get a list of all registration questions for a webinar."
+
+ms.localizationpriority: medium
+++
+# List questions
+Namespace: microsoft.graph
+
+Get a list of all [registration](../resources/virtualeventregistration.md) questions for a [webinar](../resources/virtualeventwebinar.md).
+
+The list can include either [predefined registration questions](../resources/virtualeventregistrationpredefinedquestion.md) or [custom registration questions](../resources/virtualeventregistrationcustomquestion.md).
++
+## Permissions
+
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+
+<!-- { "blockType": "permissions", "name": "virtualeventregistrationconfiguration_list_questions" } -->
+
+> [!NOTE]
+>
+> To use application permissions for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and assign it to a user. This allows the authorized application to access registration records from virtual events created by that specific user.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration/questions
+```
+
+## Optional query parameters
+
+This method does not support OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) or [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md) objects, or both in the response body.
+
+## Examples
+
+### Request
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "list_questions_virtualeventregistration"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrationConfiguration/questions
+```
+++
+### Response
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.virtualEventRegistrationQuestionBase)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.virtualEventRegistrationPredefinedQuestion",
+ "id": "630ce4da-6355-459e-81dc-541fd6b93375",
+ "displayName": "Job title",
+ "isRequired": true,
+ "label": "jobTitle"
+ },
+ {
+ "@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",
+ "id": "363dc852-452d-4e51-a1f8-a8dc72ce82cd",
+ "displayName": "In what area do you work",
+ "isRequired": false,
+ "answerInputType": "text",
+ "answerChoices": []
+ },
+ {
+ "@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",
+ "id": "e4ef3e86-9137-4d24-8440-c674f1a3df7b",
+ "displayName": "What is your primary reason for attending this webinar",
+ "isRequired": true,
+ "answerInputType": "singleChoice",
+ "answerChoices": [
+ "To gain knowledge on the topic",
+ "To network with other professionals",
+ "To earn continuing education credits"
+ ]
+ },
+ {
+ "@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",
+ "id": "e36b964f-2aed-43cf-a13e-2df4f8624652",
+ "displayName": "Are you interested in webinars of the same topic in the future",
+ "isRequired": true,
+ "answerInputType": "boolean",
+ "answerChoices": []
+ }
+ ]
+}
+```
+<!-- {
+ "type": "#page.annotation",
+ "suppressions": [
+ "Error: listquestionsvirtualeventregistration/container/answerInputType:
+ Expected type String but actual was Boolean. Property: answerInputType, actual value: 'boolean'"
+ ]
+}-->
v1.0 Virtualeventregistrationconfiguration Post Questions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistrationconfiguration-post-questions.md
+
+ Title: "Create question"
+description: "Create a registration question for a webinar."
+
+ms.localizationpriority: medium
+++
+# Create question
+Namespace: microsoft.graph
+
+Create a [registration question](../resources/virtualeventregistrationquestionbase.md) for a [webinar](../resources/virtualeventwebinar.md).
+
+You can create either a [predefined registration question](../resources/virtualeventregistrationpredefinedquestion.md) or a [custom registration question](../resources/virtualeventregistrationcustomquestion.md).
++
+## Permissions
+
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+
+<!-- { "blockType": "permissions", "name": "virtualeventregistration_post_question" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration/questions
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of etiher a [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) or a [virtualEventRegistrationPredefinedQuestion](../resources/virtualEventRegistrationPredefinedQuestion.md) object.
+
+You can specify the following properties when you create a **virtualEventRegistrationCustomQuestion**.
+
+|Property|Type|Description|
+|:|:|:|
+|answerChoices|String collection|Answer choices when **answerInputType** is `singleChoice` or `multiChoice`. |
+|answerInputType|virtualEventRegistrationQuestionAnswerInputType|Input type of the registration question answer. The supported values are `text`, `multilineText`, `singleChoice`, `multiChoice`, and `boolean`.|
+|displayName|String|Display name of the registration question.|
+|isRequired|Boolean| Indicates whether an answer to the question is required. Default value is `false`.|
+
+You can specify the following property when you create a **virtualEventRegistrationPredefinedQuestion**.
+
+|Property|Type|Description|
+|:|:|:|
+|label|virtualEventRegistrationPredefinedQuestionLabel|Label of the predefined registration question. The following label values accept a single line of text: `street`, `city`, `state`, `postalCode`, `countryOrRegion`, `industry`, `jobTitle`, and `organization`. `unknownFutureValue` is an evolvable enumeration sentinel value; do not use this label.|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and either a [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) or [virtualEventRegistrationPredefinedQuestion](../resources/virtualEventRegistrationPredefinedQuestion.md) object in the response body.
+
+## Examples
+
+### Example 1: Add a custom registration question to a webinar registration
+
+#### Request
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "post_custom_question_virtualeventregistration"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrationConfiguration/questions
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",
+ "displayName": "What's your job position?",
+ "answerInputType": "multiChoice",
+ "answerChoices": [
+ "Software Engineer",
+ "Engineer Manager",
+ "Product Manager"
+ ],
+}
+```
+++
+#### Response
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.virtualEventRegistrationCustomQuestion"
+}
+-->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",
+ "id": "f3115d4c-9896-42fc-a649-8ca5e3c3a43f",
+ "displayName": "What's your job position?",
+ "answerInputType": "multiChoice",
+ "answerChoices": [
+ "Software Engineer",
+ "Engineer Manager",
+ "Product Manager"
+ ],
+ "isRequired": false
+}
+```
+
+### Example 2: Add a predefined registration question to a webinar registration
+
+#### Request
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "post_predefined_question_virtualeventregistration"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrationConfiguration/questions
+```
+
+``` http
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.virtualEventRegistrationPredefinedQuestion",
+ "label": "street"
+}
+```
++
+#### Response
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.virtualEventRegistrationPredefinedQuestion"
+}
+-->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.virtualEventRegistrationPredefinedQuestion",
+ "id": "7a852983-013a-4062-9e97-f784c6a57ec8",
+ "label": "street",
+ "displayName": "Address",
+ "isRequired": false
+}
+```
+
v1.0 Workplace List Sensordevices https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplace-list-sensordevices.md
This method supports the `$filter`, `$top`, `$select`, and `$skipToken` [OData q
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Workplace Post Sensordevices https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplace-post-sensordevices.md
POST /workplace/sensorDevices
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Workplacesensordevice Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplacesensordevice-delete.md
DELETE /workplace/sensorDevices/{id}
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Workplacesensordevice Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplacesensordevice-get.md
This method supports the `$select` [OData query parameter](/graph/query-paramete
## Request headers | Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| 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.
v1.0 Workplacesensordevice Ingesttelemetry https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplacesensordevice-ingesttelemetry.md
POST /workplace/sensorDevices/ingestTelemetry
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Workplacesensordevice Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workplacesensordevice-update.md
PATCH /workplace/sensorDevices/{id}
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Accessreview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreview.md
Represents a Microsoft Entra [access review](accessreviews-root.md).
|[Send reminder](../api/accessreview-sendreminder.md) | None. | Send a reminder to the reviewers of an accessReview. | |[Stop](../api/accessreview-stop.md) | None. | Stop an accessReview. | |[Reset](../api/accessreview-reset.md) | None. | Reset the decisions in an in-progress accessReview. |
-|[Apply accessReview decisions](../api/accessreview-apply.md) | None. | Apply the decisions from a completed accessReview. |
+|[Apply decisions](../api/accessreview-apply.md) | None. | Apply the decisions from a completed accessReview. |
## Properties
v1.0 Accessreviewhistoryinstance https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviewhistoryinstance.md
Namespace: microsoft.graph
|Method|Return type|Description| |:--|:-|:-| |[List](../api/accessreviewhistorydefinition-list-instances.md)|[accessReviewHistoryInstance](accessreviewhistoryinstance.md) collection|Retrieve a list of the [accessReviewHistoryInstance](accessreviewhistoryinstance.md) objects and their properties.|
-|[generateDownloadUri](../api/accessreviewhistoryinstance-generatedownloaduri.md)|[accessReviewHistoryDefinition](accessreviewhistorydefinition.md)|Generates a URI that can be used to retrieve the instance's review history data.|
+|[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.|
## Properties
v1.0 Administrativeunit https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/administrativeunit.md
This resource supports:
|**Open extensions**| | | |[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties to a new or existing resource.| |[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension identified by the extension name.|
-|**Schema extensions**| | |
-|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
> [!NOTE] > The URL endpoint for calling the **administrativeUnits** API is `/administrativeUnits` in the `beta` endpoint but `/directory/administrativeUnits` in the `v1.0` endpoint.
v1.0 Call https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/call.md
https://teams.microsoft.com/l/meetup-join/19:meeting_NTg0NmQ3NTctZDVkZC00YzRhLTh
| [Mute all participants](../api/participant-muteall.md) | [commsOperation](commsoperation.md) | Mute all participants in the call. | | [Mute participant](../api/participant-mute.md) | [muteParticipantOperation](muteparticipantoperation.md) | Mute a participant in the group call. | | [Create](../api/call-post-audioroutinggroups.md) | [audioRoutingGroup](audioroutinggroup.md) | Create a new **audioRoutingGroup** by posting to the audioRoutingGroups collection. |
-| [List audioRoutingGroups](../api/call-list-audioroutinggroups.md) | [audioRoutingGroup](audioroutinggroup.md) collection | Get an **audioRoutingGroup** object collection. |
+| [List audio routing groups](../api/call-list-audioroutinggroups.md) | [audioRoutingGroup](audioroutinggroup.md) collection | Get an **audioRoutingGroup** object collection. |
| [Add large gallery view](../api/call-addlargegalleryview.md) | [addLargeGalleryViewOperation](addlargegalleryviewoperation.md) | Add the large gallery view to a call. | | **Interactive-Voice-Response** | | | | [Play prompt](../api/call-playprompt.md) | [playPromptOperation](playpromptoperation.md) | Play prompt in the call. |
v1.0 Chat https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/chat.md
Represents a chat that is a collection of [chatMessages](chatmessage.md) between
|[Remove tab from chat](../api/chat-delete-tabs.md) | None | Remove (unpin) a tab from a chat (and associated meeting).| | **Operations** ||| |[List operations](../api/chat-list-operations.md) | [teamsAsyncOperation](teamsAsyncOperation.md) collection | Get the list of async operations that ran or are running on the chat.|
-|[Get operation on chat](../api/teamsasyncoperation-get.md#example-get-operation-on-chat) | [teamsAsyncOperation](teamsAsyncOperation.md) | Get a single async operation that ran or is running on the chat.|
+|[Get operation on chat](../api/teamsasyncoperation-get.md) | [teamsAsyncOperation](teamsAsyncOperation.md) | Get a single async operation that ran or is running on the chat.|
| **Pinned messages** ||| |[List pinned messages](../api/chat-list-pinnedmessages.md)|[pinnedChatMessageInfo](../resources/pinnedchatmessageinfo.md) collection|Get a list of pinned messages in a chat.| |[Pin message](../api/chat-post-pinnedmessages.md)|[pinnedChatMessageInfo](../resources/pinnedchatmessageinfo.md)|Pin a chat message in a chat.|
v1.0 Cloudpc https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpc.md
Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in In
|[Bulk resize (deprecated)](../api/cloudpc-bulkresize.md) |[cloudPcRemoteActionResult](../resources//cloudpcremoteactionresult.md) collection|Perform a bulk resize action to resize a group of Cloud PCs that have successfully passed validation (cloudPC: validateBulkResize). If any devices can't be resized, they're labeled as "resize failed", while the remaining devices are `provisioned` for the resize process. This API is deprecated and stopped returning data on September 24, 2023. Going forward, use the [cloudPcBulkResize](../resources/cloudpcbulkresize.md) resource.| |[Bulk restore remote action (deprecated)](../api/manageddevice-bulkrestorecloudpc.md) |[cloudPcBulkRemoteActionResult](../resources/cloudpcbulkremoteactionresult.md)|Restore multiple Cloud PC devices with a single request that includes the IDs of Intune managed devices and a restore point date and time. This API is deprecated and stopped returning data on September 24, 2023. Going forward, use the [cloudPcBulkRestore](../resources/cloudpcbulkrestore.md) resource.| |[Get review status (deprecated)](../api/manageddevice-getcloudpcreviewstatus.md) |[cloudPcReviewStatus](../resources/cloudpcreviewstatus.md)|Get the review status of a specific Cloud PC device by managedDeviceId. This API is deprecated and stopped returning data on April 30, 2024. Going forward, use the [cloudPC: retrieveReviewStatus](../api/cloudpc-retrievereviewstatus.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`. Note that 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.|
+|[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.|
|[Reprovision remote action (deprecated)](../api/manageddevice-reprovisioncloudpc.md) |None|Reprovision a Cloud PC with an Intune [managed device](../resources/cloudpc.md) ID. This API is deprecated and will stop returning data on September 30, 2023. Going forward, use the [reprovision](../api/cloudpc-reprovision.md) API.| |[Resize remote action (deprecated)](../api/manageddevice-resizecloudpc.md) |None|Upgrade or downgrade an existing Cloud PC to another configuration with a new vCPU and storage size through Intune managed device ID. This API is deprecated and stopped returning data on October 30, 2023. Going forward, use the [cloudPC: resize](../api/cloudpc-resize.md) API.| |[Restore remote action (deprecated)](../api/manageddevice-restorecloudpc.md) |None|Restore a Cloud PC device to a previous state with an Intune [managed device](../resources/cloudpc.md) ID. This API is deprecated and will stop returning data on September 30, 2023. Going forward, use the [restore](../api/cloudpc-restore.md) API.|
Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in In
|aadDeviceId|String|The Microsoft Entra device ID of the Cloud PC.| |allotmentDisplayName|String|The allotment name divides tenant licenses into smaller batches or groups that help restrict the number of licenses available for use in a specific assignment. When the **provisioningType** is `dedicated`, the allotment name is `null`. Read-only.| |connectivityResult|[cloudPcConnectivityResult](../resources/cloudpcconnectivityresult.md)|The connectivity health check result of a Cloud PC, including the updated timestamp and whether the Cloud PC can be connected.|
+|deviceRegionName|String|The name of the geographical region where the Cloud PC is currently provisioned. For example, `westus3`, `eastus2`, and `southeastasia`. Read-only.|
|diskEncryptionState|[cloudPcDiskEncryptionState](#cloudpcdiskencryptionstate-values)|The disk encryption applied to the Cloud PC. Possible values: `notAvailable`, `notEncrypted`, `encryptedUsingPlatformManagedKey`, `encryptedUsingCustomerManagedKey`, and `unknownFutureValue`.| |displayName|String|The display name of the Cloud PC.| |gracePeriodEndDateTime|DateTimeOffset|The date and time when the grace period ends and reprovisioning or deprovisioning happens. Required only if the status is `inGracePeriod`. The timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in In
|powerState|[cloudPcPowerState](#cloudpcpowerstate-values)|The power state of a Cloud PC. The possible values are: `running`, `poweredOff`, `unknown`. This property only supports shift work Cloud PCs.| |provisioningPolicyId|String|The provisioning policy ID of the Cloud PC.| |provisioningPolicyName|String|The provisioning policy that is applied during the provisioning of Cloud PCs.|
-|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`, `sharedByUser`. 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. |
+|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. |
|servicePlanId|String|The service plan ID of the Cloud PC.| |servicePlanName|String|The service plan name of the Cloud PC.| |servicePlanType|[cloudPcServicePlanType](../resources/cloudpcserviceplan.md#cloudpcserviceplantype-values)|The service plan type of the Cloud PC.|
-|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`. 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`.|
-|statusDetails|[cloudPcStatusDetails](../resources/cloudpcstatusdetails.md)|The details of the Cloud PC status.|
+|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.|
|userAccountType|[cloudPcUserAccountType](../resources/cloudpcorganizationsettings.md#cloudpcuseraccounttype-values)|The account type of the user on provisioned Cloud PCs. Possible values are: `standardUser`, `administrator`, `unknownFutureValue`.| |userPrincipalName|String|The user principal name (UPN) of the user assigned to the Cloud PC.|
Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in In
|unknown|The Cloud PC status is unknown.| ### cloudPcStatus values
-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`.
+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`.
|Member|Description| |:|:|
The following table lists the members of an [evolvable enumeration](/graph/best-
|unknownFutureValue|Evolvable enumeration sentinel value. Don't use.| |movingRegion|Indicates that the Cloud PC is being moved from one region to another.| |resizePendingLicense|Indicates that the Cloud PC resize process was initiated but can't be completed because the target license hasn't been identified. It's currently awaiting customer action to resolve the licensing issue.|
+|modifyingSingleSignOn|Indicates that the Cloud PC is updating the single sign on setting.|
### frontlineCloudPcAccessState values
The following JSON representation shows the resource type.
"aadDeviceId": "String", "allotmentDisplayName": "String", "connectivityResult": "String",
+ "deviceRegionName": "String",
"diskEncryptionState": "String", "displayName": "String", "gracePeriodEndDateTime": "String (timestamp)",
v1.0 Cloudpcauditresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcauditresource.md
Represents the audit resource. This shows the target edited resource entity, w
|modifiedProperties|[cloudPcAuditProperty](../resources/cloudpcauditproperty.md) collection|A list of modified properties.| |resourceId|String|The ID of the audit resource.| |resourceType|String|The type of the audit resource.|
-|type (deprecated)|String|The type of the audit resource. The **type** property is deprecated and will stop returning data on May 8, 2024. Going forward, use the **resourceType** property.|
## Relationships
The following JSON representation shows the resource type.
"displayName": "String", "modifiedProperties": [{"@odata.type": "microsoft.graph.cloudPcAuditProperty"}], "resourceId": "String",
- "resourceType": "String",
- "type": "String"
+ "resourceType": "String"
} ```
v1.0 Cloudpcconnectionsetting https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcconnectionsetting.md
+
+ 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",
+}
+```
v1.0 Cloudpcconnectivityresult https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcconnectivityresult.md
Represents the details of the Cloud PC connectivity status, including whether th
## Properties |Property|Type|Description| |:|:|:|
-|failedHealthCheckItems|[cloudPcHealthCheckItem](../resources/cloudpchealthcheckitem.md) collection|A list of failed health check items. If the status property is `available`, this property will be empty.|
+|failedHealthCheckItems|[cloudPcHealthCheckItem](../resources/cloudpchealthcheckitem.md) collection|A list of failed health check items. If the status property is `available`, this property is empty.|
|status|[cloudPcConnectivityStatus](#cloudpcconnectivitystatus-values)|Connectivity status of the Cloud PC. Possible values are: `unknown`, `available`, `availableWithWarning`, `unavailable`, and `unknownFutureValue`.|
-|updatedDateTime|string|Datetime when the status was updated. The timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 appears as `2014-01-01T00:00:00Z`. |
+|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`. |
### cloudPcConnectivityStatus values
Represents the details of the Cloud PC connectivity status, including whether th
|available|1|The Cloud PC is able to be connected.| |availableWithWarning|2|The Cloud PC is able to be connected but there are warnings.| |unavailable|3|The Cloud PC is unable to be connected.|
-|unknownFutureValue|999|Evolvable enumeration sentinel value. Do not use.|
+|unknownFutureValue|999|Evolvable enumeration sentinel value. Don't use.|
## Relationships None. ## JSON representation
-The following is a JSON representation of the resource.
+The following JSON representation shows the resource type.
<!-- { "blockType": "resource", "@odata.type": "microsoft.graph.cloudPcConnectivityResult"
The following is a JSON representation of the resource.
"@odata.type": "#microsoft.graph.cloudPcConnectivityResult", "failedHealthCheckItems": "String", "status": "String",
- "updatedDateTime": "String (timestamp)"
+ "updatedDateTime": "String (timestamp)",
+ "lastModifiedDateTime": "String (timestamp)"
} ```
v1.0 Cloudpcremoteactionresult https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcremoteactionresult.md
Title: "cloudPcRemoteActionResult resource type"
-description: "Represents the Cloud PC-specified remote action result."
+description: "Represents a remote action result specified by a Cloud PC."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents the Cloud PC-specified remote action result.
+Represents a remote action result specified by a Cloud PC.
## Methods
Represents the Cloud PC-specified remote action result.
|managedDeviceId|String|The ID of the Intune managed device on which the remote action is performed. Read-only.| |startDateTime|DateTimeOffset|Time the action was initiated. The Timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 appears asΓÇ»'2014-01-01T00:00:00Z'.| |lastUpdatedDateTime|DateTimeOffset|Last update time for action. The Timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 appears asΓÇ»'2014-01-01T00:00:00Z'.|
-|statusDetails|[cloudPcStatusDetails](../resources/cloudpcStatusDetails.md)|The details of the Cloud PC status. |
+|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. |
+ ### actionState values |Member|Description| |:|:| |none|Not a valid action state.|
-|pending|Action is pending.|
-|canceled|Action has been canceled.|
-|active|Action is active.|
-|done|Action completed without errors.|
-|failed|Action failed.|
-|notSupported|Action isn't supported.|
+|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.|
## Relationships
The following JSON representation shows the resource type.
"managedDeviceId": "String", "statusDetails": { "@odata.type": "microsoft.graph.cloudPcStatusDetails"
+ },
+ "statusDetail": {
+ "@odata.type": "microsoft.graph.cloudPcStatusDetail"
} } ```
v1.0 Cloudpcstatusdetail https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcstatusdetail.md
+
+ 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"
+ }
+ ]
+}
+```
v1.0 Cloudpcstatusdetails https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcstatusdetails.md
Title: "cloudPcStatusDetails resource type"
+ Title: "cloudPcStatusDetails resource type (deprecated)"
description: "Represents details about the status of a Cloud PC." ms.localizationpriority: medium
doc_type: resourcePageType
-# cloudPcStatusDetails resource type
+# cloudPcStatusDetails resource type (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents details about the status of a Cloud PC.
+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.
## Properties
None.
## JSON representation
-The following is a JSON representation of the resource.
+The following JSON representation shows the resource type.
<!-- { "blockType": "resource", "@odata.type": "microsoft.graph.cloudPcStatusDetails",
v1.0 Contact https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/contact.md
by providing a [delta](../api/contact-delta.md) function.
|**Open extensions**| | | |[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties to a new or existing resource.| |[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension identified by the extension name.|
-|**Schema extensions**| | |
-|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
|**Extended properties**| | | |[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[contact](contact.md) |Create one or more single-value extended properties in a new or existing contact. | |[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md) | [contact](contact.md) | Get contacts that contain a single-value extended property by using `$expand` or `$filter`. |
v1.0 Crosstenantaccesspolicy Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/crosstenantaccesspolicy-overview.md
In the traditional Microsoft Entra B2B collaboration, any invited user from an o
Granular controls let you determine the users, groups, and apps, both in your organization and in external organizations, that can participate in cross-tenant collaboration. These controls are implemented through: + **Default cross-tenant access settings** which set the baseline settings for inbound and outbound access and tenant restrictions.
- + 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.
+ + 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.
+ In Microsoft Entra B2B direct connect, both inbound and outbound access settings are disabled by default. + The service default settings may be updated. + In Tenant Restrictions, all access settings are disabled by default.
- + The service default settings may be updated.
+ **Partner-specific access settings** which allow you to configure customized settings for individual organizations. For the configured organizations, this configuration takes precedence over the default settings. Therefore, while Microsoft Entra B2B collaboration, Microsoft Entra B2B direct connect, and tenant restrictions might be disabled across your organization, you can enable these features for a specific external organization.
v1.0 Crosstenantaccesspolicyconfigurationdefault https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/crosstenantaccesspolicyconfigurationdefault.md
Title: "crossTenantAccessPolicyConfigurationDefault resource type"
-description: "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."
+description: "Represents the default configuration for cross-tenant access and tenant restrictions."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-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.
+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.
## Methods
The default configuration for cross-tenant access and tenant restrictions. Cross
| b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) |Defines your default configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the default configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. | | invitationRedemptionIdentityProviderConfiguration | [defaultInvitationRedemptionIdentityProviderConfiguration](../resources/defaultInvitationRedemptionIdentityProviderConfiguration.md) | Defines the priority order based on which an identity provider is selected during invitation redemption for a guest user. |
-| tenantRestrictions |[crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the default tenant restrictions configuration for your organization users accessing an external organization on your network or devices. |
| isServiceDefault | Boolean | If `true`, the default configuration is set to the system default configuration. If `false`, the default settings are customized. |
+| 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. |
## Relationships
None.
## JSON representation
-The following is a JSON representation of the resource.
+The following JSON representation shows the resource type.
<!-- { "blockType": "resource", "keyProperty": "id",
The following is a JSON representation of the resource.
``` json { "@odata.type": "#microsoft.graph.crossTenantAccessPolicyConfigurationDefault",
- "automaticUserConsentSettings": {"@odata.type": "microsoft.graph.inboundOutboundPolicyConfiguration"},"inboundTrust": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyInboundTrust"
- },
- "b2bCollaborationOutbound": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"
- },
- "b2bCollaborationInbound": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"
- },
- "b2bDirectConnectOutbound": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"
- },
- "b2bDirectConnectInbound": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"
- },
- "tenantRestrictions": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyTenantRestrictions"
- },
- "invitationRedemptionIdentityProviderConfiguration": {
- "@odata.type": "microsoft.graph.defaultInvitationRedemptionIdentityProviderConfiguration"
- },
- "isServiceDefault": "Boolean"
+ "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"}
} ```
v1.0 Crosstenantaccesspolicyconfigurationpartner https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/crosstenantaccesspolicyconfigurationpartner.md
Title: "crossTenantAccessPolicyConfigurationPartner resource type"
-description: "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."
+description: "Represents the partner-specific configuration for cross-tenant access and tenant restrictions."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-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.
+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 will inherit the behavior configured in your [default cross tenant access settings](../resources/crosstenantaccesspolicyconfigurationdefault.md).
+For any partner-specific property that is `null`, these settings inherit the behavior configured in your [default cross-tenant access settings](../resources/crosstenantaccesspolicyconfigurationdefault.md).
## Methods
For any partner-specific property that is `null`, these settings will inherit th
| b2bDirectConnectInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users from other organizations accessing your resources via Azure B2B direct connect. | | b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the partner-specific configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. |
-| tenantRestrictions | [crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the partner-specific tenant restrictions configuration for your organization users accessing a partner organization using partner supplied identities on your network or devices. |
| isInMultiTenantOrganization | Boolean | Identifies whether a tenant is a member of a multitenant organization. | | isServiceProvider | Boolean | Identifies whether the partner-specific configuration is a Cloud Service Provider for your organization. | | tenantId | String | The tenant identifier for the partner Microsoft Entra organization. Read-only. Key.|
+| 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. |
## Relationships
The following JSON representation shows the resource type.
``` json { "@odata.type": "#microsoft.graph.crossTenantAccessPolicyConfigurationPartner",
- "automaticUserConsentSettings": {
- "@odata.type": "microsoft.graph.inboundOutboundPolicyConfiguration"
- },
- "tenantId": "String (identifier)",
- "inboundTrust": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyInboundTrust"
- },
- "b2bCollaborationOutbound": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"
- },
- "b2bCollaborationInbound": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"
- },
- "b2bDirectConnectOutbound": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"
- },
- "b2bDirectConnectInbound": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyB2BSetting"
- },
- "tenantRestrictions": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyTenantRestrictions"
- },
+ "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"},
"isInMultiTenantOrganization": "Boolean",
- "isServiceProvider": "Boolean"
+ "isServiceProvider": "Boolean",
+ "tenantId": "String (identifier)",
+ "tenantRestrictions": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyTenantRestrictions"}
} ```
v1.0 Crosstenantaccesspolicytarget https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/crosstenantaccesspolicytarget.md
Defines how to target your cross-tenant access policy settings. Settings can be
|Property|Type|Description| |:|:|:|
-| target | String | Can be 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 [Office365](/azure/active-directory/conditional-access/concept-conditional-access-cloud-apps#office-365) suite. |
+| 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. |
| targetType | crossTenantAccessPolicyTargetType | The type of resource that you want to target. The possible values are: `user`, `group`, `application`, `unknownFutureValue`. | ## Relationships
v1.0 Crosstenantaccesspolicytenantrestrictions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/crosstenantaccesspolicytenantrestrictions.md
Inherits from [crossTenantAccessPolicyB2BSettings](../resources/crosstenantacces
|Property|Type|Description| |:|:|:| |applications|[crossTenantAccessPolicyTargetConfiguration](../resources/crosstenantaccesspolicytargetconfiguration.md)|The list of applications targeted with your cross-tenant access policy. Inherited from [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md).|
-|devices|[devicesFilter](../resources/devicesfilter.md)|Defines the rule for filtering devices and whether devices satisfying the rule should be allowed or blocked. Not implemented.|
+|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.|
|usersAndGroups|[crossTenantAccessPolicyTargetConfiguration](../resources/crosstenantaccesspolicytargetconfiguration.md)|The list of users and groups targeted with your cross-tenant access policy. Inherited from [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md).| ## Relationships
None.
## JSON representation
-The following is a JSON representation of the resource.
+The following JSON representation shows the resource type.
+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.crossTenantAccessPolicyTenantRestrictions"
The following is a JSON representation of the resource.
``` json { "@odata.type": "#microsoft.graph.crossTenantAccessPolicyTenantRestrictions",
- "usersAndGroups": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyTargetConfiguration"
- },
- "applications": {
- "@odata.type": "microsoft.graph.crossTenantAccessPolicyTargetConfiguration"
- },
- "devices": {
- "@odata.type": "microsoft.graph.devicesFilter"
- }
+ "applications": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyTargetConfiguration"},
+ "devices": {"@odata.type": "microsoft.graph.devicesFilter"},
+ "usersAndGroups": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyTargetConfiguration"}
} ```
v1.0 Customauthenticationextension https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/customauthenticationextension.md
Learn how to use this API when [Configuring a custom claim provider token issuan
|[Get custom authentication extension](../api/customauthenticationextension-get.md)|[customAuthenticationExtension](../resources/customauthenticationextension.md)|Read the properties and relationships of an object type that is derived from **customAuthenticationExtension**.| |[Update custom authentication extension](../api/customauthenticationextension-update.md)|None|Update the properties of an object type that is derived from **customAuthenticationExtension**.| |[Delete custom authentication extension](../api/customauthenticationextension-delete.md)|None|Delete an object type that is derived from **customAuthenticationExtension**.|
-|[Validate authentication configuration](../api/customauthenticationextension-validateauthenticationconfiguration.md)|[authenticationConfigurationValidation](../resources/authenticationconfigurationvalidation.md)|Check validity of the endpoint and authentication configuration for a [customAuthenticationExtension](../resources/customauthenticationextension.md) object.|
+|[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.|
|**On attribute collection start**||| |[Get on attribute collection start](../api/onattributecollectionstartcustomextension-get.md)|[onAttributeCollectionStartCustomExtension](../resources/onattributecollectionstartcustomextension.md)|Read the properties and relationships of an [onAttributeCollectionStartCustomExtension](../resources/onattributecollectionstartcustomextension.md) object.| |[Update on attribute collection start](../api/onattributecollectionstartcustomextension-update.md)|[onAttributeCollectionStartCustomExtension](../resources/onattributecollectionstartcustomextension.md)|Update the properties of an [onAttributeCollectionStartCustomExtension](../resources/onattributecollectionstartcustomextension.md) object.|
v1.0 Devicesfilter https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/devicesfilter.md
Title: "devicesFilter resource type"
-description: "Defines a rule to filter the devices and whether devices satisfying the rule should be allowed or blocked."
+description: "Defines a rule to filter the devices and whether devices that satisfy the rule should be allowed or blocked."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Defines a rule to filter the devices and whether devices satisfying 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.
## Properties |Property|Type|Description| |:|:|:|
-|mode|crossTenantAccessPolicyTargetConfigurationAccessType|Determines whether devices satisfying the rule should be allowed or blocked.The possible values are: `allowed`, `blocked`, `unknownFutureValue`.|
+|mode|crossTenantAccessPolicyTargetConfigurationAccessType|Determines whether devices that satisfy the rule should be allowed or blocked. The possible values are: `allowed`, `blocked`, `unknownFutureValue`.|
|rule|String|Defines the rule to filter the devices. For example, `device.deviceAttribute2 -eq 'PrivilegedAccessWorkstation'`.| ## Relationships
None.
## JSON representation
-The following is a JSON representation of the resource.
+The following JSON representation shows the resource type.
+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.devicesFilter"
v1.0 Driveitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/driveitem.md
Items with the **folder** facet act as containers of items and therefore have a
## Methods
-| Method | REST Path |
-|:--|:--|
-| [Get item](../api/driveitem-get.md) | `GET /drive/items/{item-id}` |
-| [List activities](../api/activities-list.md) | `GET /drive/items/{item-id}/activities` |
-| [Get analytics][] | `GET /drive/items/{item-id}/analytics` |
-| [Get activities by interval][] | `GET /drive/items/{item-id}/getActivitiesByInterval` |
-| [List children](../api/driveitem-list-children.md) | `GET /drive/items/{item-id}/children` |
-| [List versions](../api/driveitem-list-versions.md) | `GET /drive/items/{item-id}/versions` |
-| [Create folder](../api/driveitem-post-children.md) | `POST /drive/items/{item-id}/children` |
-| [Update item](../api/driveitem-update.md) | `PATCH /drive/items/{item-id}` |
-| [Upload](../api/driveitem-put-content.md) | `PUT /drive/items/{item-id}/content` |
-| [Download content](../api/driveitem-get-content.md) (deprecated) | `GET /drive/items/{item-id}/content` |
-| [Download file](../api/driveitem-get-contentstream.md) | `GET /drive/items/{item-id}/contentStream` |
-| [Download specific file format][download-format] | `GET /drive/items/{item-id}/content?format={format}` |
-| [Delete item](../api/driveitem-delete.md) | `DELETE /drive/items/{item-id}` |
-| [Permanently delete item](../api/driveitem-permanentdelete.md) | `POST /drives/{driveId}/items/{itemId}/permanentDelete` |
-| [Restore item](../api/driveitem-restore.md) | `POST /drive/items/{item-id}/restore` |
-| [Move item](../api/driveitem-move.md) | `PATCH /drive/items/{item-id}` |
-| [Copy item](../api/driveitem-copy.md) | `POST /drive/items/{item-id}/copy` |
-| [Search items](../api/driveitem-search.md) | `GET /drive/items/{item-id}/search(q='text')` |
-| [Track changes](../api/driveitem-delta.md) | `GET /drive/root/delta` |
-| [Follow item](../api/driveitem-follow.md) | `POST /drives/{drive-id}/items/{item-id}/follow` |
-| [Unfollow item](../api/driveitem-unfollow.md) | `POST /drives/{drive-id}/items/{item-id}/unfollow` |
-| [Get thumbnails](../api/driveitem-list-thumbnails.md) | `GET /drive/items/{item-id}/thumbnails` |
-| [Create sharing link](../api/driveitem-createlink.md) | `POST /drive/items/{item-id}/createLink` |
-| [Add permissions](../api/driveitem-invite.md) | `POST /drive/items/{item-id}/invite` |
-| [List permissions](../api/driveitem-list-permissions.md) | `GET /drive/items/{item-id}/permissions` |
-| [Delete permission](../api/permission-delete.md) | `DELETE /drive/items/{item-id}/permissions/{perm-id}` |
-| [Get WebSocket channel][getWebSocket] | `GET /drive/root/subscriptions/socketIo` |
-| [Preview item][item-preview] | `POST /drive/items/{item-id}/preview` |
-| [Check in files](../api/driveitem-checkin.md) | `POST /drives/{driveId}/items/{itemId}/checkin` |
-| [Check out files](../api/driveitem-checkout.md) | `POST /drives/{driveId}/items/{itemId}/checkout` |
-| [Revoke grants on sharing link](../api/permission-revokegrants.md) | `PATCH /drive/items/{item-id}/permissions/{perm-id}/revokeGrants` |
-| [Extract sensitivity labels](../api/driveitem-extractsensitivitylabels.md) | `POST /drive/items/{item-id}/extractSensitivityLabels` |
-| [Assign sensitivity label](../api/driveitem-assignsensitivitylabel.md) | `POST /drive/items/{item-id}/assignSensitivityLabel` |
-| [Get retention label](../api/driveitem-getretentionlabel.md) | `GET /drives/{drive-id}/items/{id}/retentionLabel` |
-| [Set retention label](../api/driveitem-setretentionlabel.md) | `PATCH /drives/{drive-id}/items/{id}/retentionLabel` |
-| [Remove retention label](../api/driveitem-removeretentionlabel.md) | `DELETE /drives/{drive-id}/items/{id}/retentionLabel` |
-| [Lock or unlock record](../api/driveitem-lockorunlockrecord.md) | `PATCH /drives/{drive-id}/items/{id}/retentionLabel` |
+| Method | Return Type | Description |
+|:--|:|:-|
+| [Get item](../api/driveitem-get.md) | [driveItem](../resources/driveitem.md) |Retrieve the metadata for a **driveItem** in a drive.|
+| [Get analytics][] | [itemAnalytics][] | Get analytics for this resource.|
+| [Get activities by interval][] | [itemActivityStat](../resources/itemactivitystat.md) | Get a collection of **itemActivityStats** within the specified time interval.|
+| [List children](../api/driveitem-list-children.md) | [driveItem](../resources/driveitem.md) collection | Return a collection of **driveItems** in the children relationship of a **driveItem**.|
+| [List versions](../api/driveitem-list-versions.md) | [driveItemVersion][] collection | Retrieve the versions of a file in the current user's drive.|
+| [Create folder](../api/driveitem-post-children.md) | [driveItem](../resources/driveitem.md) | Create a **driveItem** in the specified drive.|
+| [Update item](../api/driveitem-update.md) | [driveItem](../resources/driveitem.md) | Update a **driveItem** in the drive.|
+| [Upload](../api/driveitem-put-content.md) | [driveItem](../resources/driveitem.md) | Upload content to the **driveItem**.|
+| [Download file content](../api/driveitem-get-contentstream.md) | Stream |Download the contents of the primary stream (file) of a **driveItem**. |
+| [Download specific file format][download-format] | download URL | Download content of a **driveItem** with a specific format.|
+| [Delete item](../api/driveitem-delete.md) | None | Delete a **driveItem**.|
+| [Permanently delete item](../api/driveitem-permanentdelete.md) | None | Permanently delete a **driveItem** by using its ID. |
+| [Move item](../api/driveitem-move.md) | [driveItem](../resources/driveitem.md) | Move a **driveItem** to a new parent item.|
+| [Copy item](../api/driveitem-copy.md) | details about how to [monitor the progress](/graph/long-running-actions-overview) of the copy | Create a copy of a **driveItem** (including any children).|
+| [Search items](../api/driveitem-search.md) | [driveItem](../resources/driveitem.md) collection | Search the hierarchy of items for items matching a query.|
+| [Track changes](../api/driveitem-delta.md) | delta link | List any changes in the drive.|
+| [Follow item](../api/driveitem-follow.md) | [driveItem](../resources/driveitem.md) | Follow a **driveItem**.|
+| [Unfollow item](../api/driveitem-unfollow.md) | None | Unfollow a **driveItem**.|
+| [Get thumbnails](../api/driveitem-list-thumbnails.md) | [driveItem](../resources/driveitem.md) collection | List **driveItems** with their thumbnails.|
+| [Create sharing link](../api/driveitem-createlink.md) | sharing link | Create a link to share the **driveItem**.|
+| [Add permissions](../api/driveitem-invite.md) | [permission][] collection | Send a sharing invite to a user.|
+| [List permissions](../api/driveitem-list-permissions.md) | [permission][] collection | Retrieve the collection of permissions on a **driveItem**.|
+| [Create permission](../api/driveitem-post-permissions.md) | [permission][] | Create a permission on a **driveItem**.|
+| [Delete permission](../api/permission-delete.md) | None | Remove the permission from the **driveItem**.|
+| [Revoke grants on sharing link](../api/permission-revokegrants.md)| [permission][] | Revoke access to a **listItem** or **driveItem** granted via a sharing link by removing the specified recipient from the link.|
+| [Get WebSocket channel][getWebSocket] | [subscription][] | Receive near-real-time change notifications for a drive using socket.io.|
+| [Preview item][item-preview] | json object | Obtain short-lived embeddable URLs for an item in order to render a temporary preview.|
+| [Check in files](../api/driveitem-checkin.md) | None| Check in a checked out **driveItem** resource, which makes the version of the document available to others. |
+| [Check out files](../api/driveitem-checkout.md) | None| Check out a **driveItem** resource to prevent others from editing the document, and prevent your changes from being visible until the documented is [checked in](../api/driveitem-checkin.md). |
+| [Extract sensitivity labels](../api/driveitem-extractsensitivitylabels.md) | [extractSensitivityLabelsResult](../resources/extractsensitivitylabelsresult.md) | Extract one or more sensitivity labels assigned to a drive item and update the metadata of a drive item with the latest details of the assigned label. |
+| [Assign sensitivity label](../api/driveitem-assignsensitivitylabel.md) | String | Asynchronously assign a sensitivity label to a **driveItem**.|
+| [Get retention label](../api/driveitem-getretentionlabel.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Get metadata information for a retention label applied on a **driveItem**. |
+| [Set retention label](../api/driveitem-setretentionlabel.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Apply (set) a retention label on a **driveItem** (files and folders). |
+| [Remove retention label](../api/driveitem-removeretentionlabel.md) | None | Remove a retention label from a **driveItem**. |
+| [Lock or unlock record](../api/driveitem-lockorunlockrecord.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Lock or unlock a retention label on a **driveItem** that classifies content as records. |
+| [Download file (deprecated)](../api/driveitem-get-content.md) | download URL | Download content of a **driveItem**.|
## Properties
v1.0 Dynamics Countriesregions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/dynamics-countriesregions.md
Represents a countryRegion object in Dynamics 365 Business Central, which is par
| Method | Return Type |Description | |:--|:|:--|
-|[Get countries/regions](../api/dynamics-countriesregions-get.md) |countryRegion|Get a Countries/Regions. |
-|[Create countries/regions](../api/dynamics-create-countriesregions.md) |countryRegion|Create a Countries/Regions.|
-|[Patch countryRegion](../api/dynamics-countriesregions-update.md) |countryRegion|Update a Countries/Regions.|
-|[Delete countries/regions](../api/dynamics-countriesregions-delete.md)|none |Delete a Countries/Regions.|
+|[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.|
## Properties | Property | Type |Description |
v1.0 Ediscovery Custodian https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ediscovery-custodian.md
In the context of eDiscovery, represents a user and all of their digital assets,
|[Update](../api/ediscovery-custodian-update.md)|[microsoft.graph.ediscovery.custodian](../resources/ediscovery-custodian.md)|Update the properties of a **custodian** object.| |[Release](../api/ediscovery-custodian-release.md)|None|Release a custodian from a case.| |[Activate](../api/ediscovery-custodian-activate.md)|None|Reactivate a custodian that has been released from a case and make them part of the case again.|
-|[List siteSources](../api/ediscovery-custodian-list-sitesources.md)|[microsoft.graph.ediscovery.siteSource](../resources/ediscovery-sitesource.md) collection|Get the **siteSource** resources associated with the custodian.|
-|[Create siteSources](../api/ediscovery-custodian-post-sitesources.md)|[microsoft.graph.ediscovery.siteSource](../resources/ediscovery-sitesource.md)|Create a new **siteSource** object.|
-|[List unifiedGroupSources](../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 unifiedGroupSources](../api/ediscovery-custodian-post-unifiedgroupsources.md)|[microsoft.graph.ediscovery.unifiedGroupSource](../resources/ediscovery-unifiedgroupsource.md)|Create a new **unifiedGroupSource** object.|
-|[List userSources](../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 userSources](../api/ediscovery-custodian-post-usersources.md)|[microsoft.graph.ediscovery.userSource](../resources/ediscovery-usersource.md)|Create a new **userSource** object.|
+|[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.|
## Properties
v1.0 Ediscovery Legalhold https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ediscovery-legalhold.md
Inherits from [entity](../resources/entity.md).
|[Get](../api/ediscovery-legalhold-get.md)|[microsoft.graph.ediscovery.legalHold](../resources/ediscovery-legalhold.md)|Read the properties and relationships of a **legalHold** object.| |[Update](../api/ediscovery-legalhold-update.md)|[microsoft.graph.ediscovery.legalHold](../resources/ediscovery-legalhold.md)|Update the properties of a **legalHold** object.| |[Delete](../api/ediscovery-legalhold-delete.md)|None|Delete a **legalHold** object.|
-|[List siteSources](../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 siteSource](../api/ediscovery-legalhold-post-sitesources.md)|[microsoft.graph.ediscovery.siteSource](../resources/ediscovery-sitesource.md)|Create a new siteSource object.|
-|[List userSources](../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 userSource](../api/ediscovery-legalhold-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.|
## Properties
v1.0 Ediscovery Sourcecollection https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/ediscovery-sourcecollection.md
Represents an eDiscovery collection, commonly known as a search. For details, se
|:|:|:| |[Add additional sources](../api/ediscovery-sourcecollection-post-additionalsources.md)|[microsoft.graph.ediscovery.dataSource](../resources/ediscovery-datasource.md) collection|Add an additional **dataSource** object to the source collection.| |[Add custodian sources](../api/ediscovery-sourcecollection-post-custodiansources.md)|[microsoft.graph.ediscovery.dataSource](../resources/ediscovery-datasource.md) collection|Add a custodian **dataSource** object to the source collection.|
-|[Add noncustodialSource](../api/ediscovery-sourcecollection-post-noncustodialsources.md)|[microsoft.graph.ediscovery.noncustodialSource](../resources/ediscovery-noncustodialdatasource.md) collection|Add a non-custodial source **noncustodialSource** object to the source collection.|
+|[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](../api/ediscovery-case-list-sourcecollections.md)|[microsoft.graph.ediscovery.sourceCollection](../resources/ediscovery-sourcecollection.md) collection|Get a list of the **sourceCollection** objects and their properties.| |[Create](../api/ediscovery-case-post-sourcecollections.md)|[microsoft.graph.ediscovery.sourceCollection](../resources/ediscovery-sourcecollection.md)|Create a new **sourceCollection** object.| |[Get](../api/ediscovery-sourcecollection-get.md)|[microsoft.graph.ediscovery.sourceCollection](../resources/ediscovery-sourcecollection.md)|Read the properties and relationships of a **sourceCollection** object.|
Represents an eDiscovery collection, commonly known as a search. For details, se
|[Estimate statistics](../api/ediscovery-sourcecollection-estimatestatistics.md)|None|Run an estimate of the number of emails and documents in the source collection.| |[List additional sources](../api/ediscovery-sourcecollection-list-additionalsources.md)|[microsoft.graph.ediscovery.dataSource](../resources/ediscovery-datasource.md) collection|Get a list of additional **dataSource** objects associated with a source collection.| |[List custodian sources](../api/ediscovery-sourcecollection-list-custodiansources.md)|[microsoft.graph.ediscovery.dataSource](../resources/ediscovery-datasource.md) collection|Get a list of custodian **dataSource** objects associated with a source collection.|
-|[List noncustodialSources](../api/ediscovery-sourcecollection-list-noncustodialsources.md)|[microsoft.graph.ediscovery.noncustodialSource](../resources/ediscovery-noncustodialdatasource.md) collection|Get a list of non-custodial sources **noncustodialSource** objects associated with a 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.|
|[Purge data](../api/ediscovery-sourcecollection-purgedata.md)|None|Run a purge data operation on the Teams data contained in the source collection.| ## Properties
Represents an eDiscovery collection, commonly known as a search. For details, se
|allTenantMailboxes|Include all tenant mailboxes in the **sourceCollection**.| |allTenantSites|Include all tenant sites in the **sourceCollection**.| |allCaseCustodians|Include all custodian locations in the **sourceCollection**.|
-|allCaseNoncustodialDataSources|Include all non-custodial data sources in the **sourceCollection**.|
+|allCaseNoncustodialDataSources|Include all noncustodial data sources in the **sourceCollection**.|
## Relationships
v1.0 Educationgradingscheme https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationgradingscheme.md
Inherits from [entity](../resources/entity.md).
## Methods |Method|Return type|Description| |:|:|:|
-|[Get](../api/educationassignmentsettings-get.md)|[educationGradingScheme](../resources/educationgradingscheme.md) collection|Get a list of the [educationGradingScheme](../resources/educationgradingscheme.md) objects and their properties.|
-|[Create grading scheme](../api/educationassignment-post-gradingscheme.md)|[educationGradingScheme](../resources/educationgradingscheme.md)|Create a new [educationGradingScheme](../resources/educationgradingscheme.md) object.|
-|[Get educationGradingScheme](../api/educationgradingscheme-get.md)|[educationGradingScheme](../resources/educationgradingscheme.md)|Read the properties and relationships of an [educationGradingScheme](../resources/educationgradingscheme.md) object.|
-|[Update educationGradingScheme](../api/educationgradingscheme-update.md)|[educationGradingScheme](../resources/educationgradingscheme.md)|Update the properties of an [educationGradingScheme](../resources/educationgradingscheme.md) object.|
-|[Delete grading scheme](../api/educationgradingscheme-delete.md)|None|Delete an [educationGradingScheme](../resources/educationgradingscheme.md) object.|
+|[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.|
## Properties |Property|Type|Description|
v1.0 Educationroot https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationroot.md
Some objects in the `/education` namespace can be found in other parts of Micros
| Method | Return Type |Description| |:|:--|:-|
-|[Create class](../api/educationroot-post-classes.md) |[educationClass](educationclass.md)| Create a new **educationClass** by posting to the classes collection.|
|[List classes](../api/educationroot-list-classes.md) |[educationClass](educationclass.md) collection| Get an **educationClass** object collection.|
-|[Create school](../api/educationroot-post-schools.md) |[educationSchool](educationschool.md)| Create a new **educationSchool** by posting to the schools collection.|
+|[Create class](../api/educationroot-post-classes.md) |[educationClass](educationclass.md)| Create a new **educationClass** by posting to the classes collection.|
|[List schools](../api/educationroot-list-schools.md) |[educationSchool](educationschool.md) collection| Get an **educationSchool** object collection.|
-|[Create educationUser](../api/educationroot-post-users.md) |[educationUser](educationuser.md)| Create a new **educationUser** by posting to the users collection.|
+|[Create school](../api/educationroot-post-schools.md) |[educationSchool](educationschool.md)| Create a new **educationSchool** by posting to the schools collection.|
|[List users](../api/educationroot-list-users.md) |[educationUser](educationuser.md) collection| Get an **educationUser** object collection.|
+|[Create user](../api/educationroot-post-users.md) |[educationUser](educationuser.md)| Create a new **educationUser** by posting to the users collection.|
## Properties None.
v1.0 Educationschool https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationschool.md
This resource is a subtype of [educationOrganization](educationorganization.md).
| [Add user](../api/educationschool-post-users.md) | [educationUser](educationuser.md) | Add a new **educationUser** for the school by posting to the **users** navigation property. | | [List users](../api/educationschool-list-users.md) | [educationUser](educationuser.md) collection | Get the **educationUser** object collection. | | [Remove user](../api/educationschool-delete-users.md) | [educationUser](educationuser.md) | Remove an **educationUser** from the school through the **users** navigation property. |
-| [Get administrativeUnit](../api/educationschool-get-administrativeunit.md) | [administrativeUnit](administrativeunit.md) | Get the **administrativeUnit** that corresponds to this **educationSchool**. |
+| [Get administrative unit](../api/educationschool-get-administrativeunit.md) | [administrativeUnit](administrativeunit.md) | Get the **administrativeUnit** that corresponds to this **educationSchool**. |
| [Update school](../api/educationschool-update.md) | [educationSchool](educationschool.md) | Update an **educationSchool** object. | | [Delete school](../api/educationschool-delete.md) | None | Delete an **educationSchool** object. | | [Get delta](../api/educationschool-delta.md) | [educationSchool](educationschool.md) collection | Get incremental changes for **educationSchools** |
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/enums.md
Namespace: microsoft.graph
+### virtualEventRegistrationPredefinedQuestionLabel values
+
+| Member |
+|:-|
+| street |
+| city |
+| state |
+| postalCode |
+| countryOrRegion |
+| industry |
+| jobTitle |
+| organization |
+| unknownFutureValue |
+ ### fileStorageContainerOwnershipType values | Member |
v1.0 Event https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/event.md
This resource supports:
|**Open extensions**| | | |[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties to a new or existing resource.| |[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension identified by the extension name.|
-|**Schema extensions**| | |
-|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
|**Extended properties**| | | |[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[event](event.md) |Create one or more single-value extended properties in a new or existing event. | |[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md) | [event](event.md) | Get events that contain a single-value extended property by using `$expand` or `$filter`. |
v1.0 Filestoragecontainer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/filestoragecontainer.md
Represents a location where multiple users or a group of users can store files a
|[Delete file storage container column](../api/filestoragecontainer-delete-column.md)|None|Delete a column from a fileStorageContainer.| |[Get column](../api/filestoragecontainer-get-column.md)|[columnDefinition](../resources/columndefinition.md)|Get a column from a fileStorageContainer.| |[Restore recycle bin items](../api/filestoragecontainer-restore-recyclebin-items.md)|[recycleBinItem](../resources/recyclebinitem.md) collection|Restore recycle bin items in a fileStorageContainer.|
-|[Delete recyclebin items](../api/filestoragecontainer-delete-recyclebin-items.md)|None|Delete recycle bin items from a fileStorageContainer.|
+|[Delete recycle bin items](../api/filestoragecontainer-delete-recyclebin-items.md)|None|Delete recycle bin items from a fileStorageContainer.|
|[Get recycle bin items](../api/filestoragecontainer-list-recyclebin-items.md)|[recycleBinItem](../resources/recyclebinitem.md) collection|List recycle bin items in a fileStorageContainer.| |[Lock](../api/filestoragecontainer-lock.md)|None|Lock a [fileStorageContainer](../resources/filestoragecontainer.md).| |[Unlock](../api/filestoragecontainer-unlock.md)|None|Unlock a [fileStorageContainer](../resources/filestoragecontainer.md).|
v1.0 Identityuserflowattributeassignment https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identityuserflowattributeassignment.md
identityUserFlowAttributeAssignments are used to collect specific identityUserFl
|[Get](../api/identityuserflowattributeassignment-get.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md)|Read the properties and relationships of an identityUserFlowAttributeAssignment object.| |[Update](../api/identityuserflowattributeassignment-update.md)|None|Update the properties of an identityUserFlowAttributeAssignment object.| |[Delete](../api/identityuserflowattributeassignment-delete.md)|None|Delete a specific identityUserFlowAttributeAssignment object.|
-|[getOrder](../api/identityuserflowattributeassignment-getorder.md)|[assignmentOrder](../resources/assignmentorder.md)|Gets the order of the identityUserFlowAttributes being collected within a user flow.|
-|[setOrder](../api/identityuserflowattributeassignment-setorder.md)|None|Sets the order of the identityUserFlowAttributes being collected within a user flow.|
+|[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.|
## Properties
v1.0 Linkedresource_V2 https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/linkedresource_v2.md
Some **linkedResource** objects aren't associated with any web URLs, in which ca
|:|:|:| |[List](../api/basetask-list-linkedresources.md)|[linkedResource_v2](../resources/linkedresource_v2.md) collection|Get a list of the [linkedResource_v2](../resources/linkedresource_v2.md) objects and their properties.| |[Create](../api/basetask-post-linkedresources.md)|[linkedResource_v2](../resources/linkedresource_v2.md)|Create a new [linkedResource_v2](../resources/linkedresource_v2.md) object.|
-|[Get linkedResource_v2](../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 linkedResource_v2](../api/linkedresource_v2-update.md)|[linkedResource_v2](../resources/linkedresource_v2.md)|Update the properties of a [linkedResource_v2](../resources/linkedresource_v2.md) object.|
-|[Delete linkedResource_v2](../api/linkedresource_v2-delete.md)|None|Deletes a [linkedResource_v2](../resources/linkedresource_v2.md) object.|
+|[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.|
## Properties |Property|Type|Description|
v1.0 List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/list.md
Represents a list in a [site](site.md). This resource contains the top level pro
| Method | Return Type | Description | |:--|:--|:|
+| [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**. |
| [Get lists in a site](../api/list-list.md) | [list](../resources/list.md) collection | Get the collection of **lists** in a [site](site.md). |
-| [Create list](../api/list-create.md) | [list](../resources/list.md) | Create a new **list** in a **site**. |
-| [Get list](../api/list-get.md) | [list](../resources/list.md) | Get the metadata for a **list**. |
| [Get recent activities](../api/activities-list.md) | [itemActivity](../resources/itemactivity.md) collection | List the recent [activities](../resources/itemactivity.md) that took place on an item or under a hierarchy. |
-| [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**. |
| [Update item](../api/listitem-update.md) | [listItem](../resources/listitem.md) | Update the properties on a [listItem]( ../resources/listitem.md). | | [Delete item](../api/listitem-delete.md) | None | Delete a [listItem]( ../resources/listitem.md) from a **list**. |
-| [Create item](../api/listitem-create.md) | [listItem](../resources/listitem.md) | Create a new [listItem]( ../resources/listitem.md) in a **list**. |
| [Get websocket endpoint](../api/subscriptions-socketio.md) | [subscription](../resources/subscription.md) | Get near-real-time change notifications for a [drive](../resources/drive.md) and **list** using [socket.io](https://socket.io/). | | [List operations in a list](../api/list-list-operations.md) | [richLongRunningOperation](../resources/richlongrunningoperation.md) collection | Get a list of [rich long-running operations](../resources/richlongrunningoperation.md) associated with a **list**. | | [List content types](../api/list-list-contenttypes.md) | [contentType](../resources/contenttype.md) collection | Get the collection of [contentType](../resources/contenttype.md) resources in a **list**. | | [Add copy to list](../api/contenttype-addcopy.md) | [contentType](../resources/contenttype.md) | Add a copy of a [contentType](../resources/contenttype.md) from a [site](site.md) to a **list**. | | [List columns](../api/list-list-columns.md) | [columnDefinition](../resources/columndefinition.md) collection | Get the collection of columns, represented as [columnDefinition](../resources/columndefinition.md) objects, in a **list**. | | [Create column](../api/list-post-columns.md) | [columnDefinition](../resources/columndefinition.md) | Create a column for a **list** with a request that specifies a [columnDefinition](../resources/columndefinition.md). |
+| [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).|
## Properties
Represents a list in a [site](site.md). This resource contains the top level pro
| drive | [drive](drive.md) | Allows access to the list as a **drive** resource with [driveItems](driveitem.md). Only present on document libraries. | | items | [listItem](listitem.md) collection | All items contained in the list. | | operations | [richLongRunningOperation](../resources/richlongrunningoperation.md) collection | The collection of long-running operations on the list. |
+| permissions | [permission](permission.md) collection | The set of permissions for the item. Read-only. Nullable. |
| subscriptions | [subscription](subscription.md) collection | The set of subscriptions on the list. | ## JSON representation
v1.0 Listitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/listitem.md
Column values in the list are available through the `fieldValueSet` dictionary.
## Methods The following tasks are available for **listItem** resources.
-All examples below are relative to a **[list][]**, eg: `https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}`.
-
-| Common task | HTTP method |
-| :-- | :- |
-| [Get][] | GET /items/{item-id} |
-| [Get column values][Get] | GET /items/{item-id}?expand=fields |
-| [Get analytics][] | GET /items/{item-id}/analytics |
-| [Get activities by interval][] | GET /items/{item-id}/getActivitiesByInterval |
-| [Create][] | POST /items |
-| [Delete][] | DELETE /items/{item-id} |
-| [Update][] | PATCH /items/{item-id} |
-| [Update column values][Update] | PATCH /items/{item-id}/fields |
-| [createLink][CreateLink] | POST /items/{itemId}/createLink |
-| [List](../api/listitem-list-documentsetversions.md)| GET /items/{item-id}/documentSetVersions |
-| [Create](../api/listitem-post-documentsetversions.md)| POST /items/{item-id}/documentSetVersions |
-| [Restore](../api/documentsetversion-restore.md)| POST /items/{item-id}/documentSetVersions/{documentSetVersion-id}/restore |
-| [Get delta][item-changes] | GET /items/{item-id}/delta
+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).|
[Get]: ../api/listitem-get.md [Get analytics]: ../api/itemanalytics-get.md
-[Get activities by interval]: ../api/itemactivity-getbyinterval.md
[Create]: ../api/listitem-create.md [Delete]: ../api/listitem-delete.md [Update]: ../api/listitem-update.md
-[CreateLink]: ../api/listitem-createlink.md
-[item-changes]: ../api/listitem-delta.md
+[itemActivityStat]: itemactivitystat.md
+[fieldValueSet]: fieldvalueset.md
+[documentSetVersion]: documentsetversion.md
## Properties
The following properties are inherited from **[baseItem][]**.
|documentSetVersions|[documentSetVersion](../resources/documentsetversion.md) collection| Version information for a document set version created by a user.| | driveItem | [driveItem][] | For document libraries, the **driveItem** relationship exposes the listItem as a **[driveItem][]** | | fields | [fieldValueSet][] | The values of the columns set on this list item. |
+| permissions | [permission](permission.md) collection | The set of permissions for the item. Read-only. Nullable. |
| versions | [listItemVersion][] collection | The list of previous versions of the list item. | ## JSON representation
v1.0 Message https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/message.md
by providing a [delta](../api/message-delta.md) function.
|**Open extensions**| | | |[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties to a new or existing resource.| |[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension identified by the extension name.|
-|**Schema extensions**| | |
-|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
|**Extended properties**| | | |[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[message](message.md) |Create one or more single-value extended properties in a new or existing message. | |[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md) | [message](message.md) | Get messages that contain a single-value extended property by using `$expand` or `$filter`. |
v1.0 Networkaccess Forwardingpolicylink https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/networkaccess-forwardingpolicylink.md
Inherits from [microsoft.graph.networkaccess.policyLink](../resources/networkacc
|Method|Return type|Description| |:|:|:| |[List](../api/networkaccess-forwardingprofile-list-policies.md)|[microsoft.graph.networkaccess.forwardingPolicyLink](../resources/networkaccess-forwardingpolicylink.md) collection|Get a list of the [microsoft.graph.networkaccess.forwardingPolicyLink](../resources/networkaccess-forwardingpolicylink.md) objects and their properties.|
-|[Get forwardingPolicyLink](../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.|
+|[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.|
|[Update](../api/networkaccess-forwardingpolicylink-update.md)|[microsoft.graph.networkaccess.forwardingPolicyLink](../resources/networkaccess-forwardingpolicylink.md)|Update the properties of a [microsoft.graph.networkaccess.forwardingPolicyLink](../resources/networkaccess-forwardingpolicylink.md) object.| |[Delete](../api/networkaccess-forwardingpolicylink-delete.md)|None|Delete a [microsoft.graph.networkaccess.forwardingPolicyLink](../resources/networkaccess-forwardingpolicylink.md) object.|
v1.0 Onlinemeeting https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onlinemeeting.md
Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md).
| allowTranscription | Boolean | Indicates whether transcription is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | allowRecording | Boolean | Indicates whether recording is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. 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. |
| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the meeting. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| 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. |
| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md).|
-| broadcastSettings (deprecated) | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event. |
| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | creationDateTime | DateTime | The meeting creation time in UTC. Read-only. | | endDateTime | DateTime | The meeting end time in UTC. Required when you create an online meeting. |
Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md).
| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in 'Accept-Language' request HTTP header. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | joinWebUrl | String | The join URL of the online meeting. The format of the URL may change; therefore, users shouldn't rely on any information extracted from parsing the URL. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
-| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
+| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
| meetingTemplateId | String | The ID of the [meeting template](/microsoftteams/create-custom-meeting-template). | | participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting, including the organizer and the attendees. | | recordAutomatically | Boolean | Indicates whether to record the meeting automatically. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| 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. |
-| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. |
| startDateTime | DateTime | The meeting start time in UTC. Required when you create an online meeting. |
-| subject | String | The subject of the online meeting. Required when you create an online meeting. |
-| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. |
-| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark. |
| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| startDateTime | DateTime | The meeting start time in UTC. |
| subject | String | The subject of the online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. 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. |
| autoAdmittedUsers (deprecated) | String | The setting that specifies the type of participants that are automatically allowed into the online meeting. Possible values are: `everyone`, `everyoneInSameAndFederatedCompany`, `everyoneInCompany`, `invitedUsersInCompany`, `organizer`. Read-only. |
-| isBroadcast (deprecated) | Boolean | Indicates whether this event is a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). |
+| broadcastSettings (deprecated) | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event. |
| capabilities (deprecated) | meetingCapabilities collection | The list of meeting capabilities. Possible values are: `questionAndAnswer`,`unknownFutureValue`. |
+| 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. |
> [!CAUTION] >
->- The **autoAdmittedUsers** property is deprecated. Use the **scope** property of [lobbyBypassSettings](lobbyBypassSettings.md) instead.
+>- The **autoAdmittedUsers** property is deprecated. Use the **scope** property of [lobbyBypassSettings](lobbybypasssettings.md) instead.
>- The **capabilities** property is deprecated. Use the **isQuestionAndAnswerEnabled** property of [broadcastMeetingSettings](broadcastMeetingSettings.md) instead. ### onlineMeetingPresenters values
v1.0 Orgcontact https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/orgcontact.md
This resource supports using [delta query](/graph/delta-query-overview) to track
| [Get org contact](../api/orgcontact-get.md) | [orgContact](orgcontact.md) | Read properties and relationships of orgContact object. | | **Organizational hierarchy** | | [Get manager](../api/orgcontact-get-manager.md) | [directoryObject](directoryobject.md) | Get the contact's manager. |
-| [Get transitiveReports](../api/orgcontact-get-transitivereports.md) | Integer | Get the count of transitive reports for an organization contact from the transitiveReports navigation property. |
+| [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 direct reports](../api/orgcontact-list-directreports.md) | [directoryObject](directoryobject.md) collection | List the contact's direct reports. | | [List memberOf](../api/orgcontact-list-memberof.md) | [directoryObject](directoryobject.md) collection | Get a memberOf object collection. | | [Check member groups](../api/directoryobject-checkmembergroups.md) | String collection | Check for group membership. |
v1.0 Outlooktaskgroup https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlooktaskgroup.md
In Outlook, there's a default task group `My Tasks` which you can't rename or de
| Method | Return Type |Description| |:|:--|:-| |[Get](../api/outlooktaskgroup-get.md) | [outlookTaskGroup](outlooktaskgroup.md) |Get the properties and relationships of the specified Outlook task group.|
-|[Create outlookTaskFolder](../api/outlooktaskgroup-post-taskfolders.md) |[outlookTaskFolder](outlooktaskfolder.md)| Create an Outlook task folder.|
-|[List taskFolders](../api/outlooktaskgroup-list-taskfolders.md) |[outlookTaskFolder](outlooktaskfolder.md) collection| Get a collection of Outlook task folders.|
|[Update](../api/outlooktaskgroup-update.md) | [outlookTaskGroup](outlooktaskgroup.md) |Update the writable properties of an Outlook task group. | |[Delete](../api/outlooktaskgroup-delete.md) | None |Delete the specified Outlook task group. |
+|[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.|
## Properties | Property | Type |Description|
v1.0 Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/post.md
This resource lets you add your own data to custom properties using [extensions]
|**Open extensions**| | | |[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties to a new or existing resource.| |[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension identified by the extension name.|
-|**Schema extensions**| | |
-|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
|**Extended properties**| | | |[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[post](post.md) |Create one or more single-value extended properties in a new or existing post. | |[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md) | [post](post.md) | Get posts that contain a single-value extended property by using `$expand` or `$filter`. |
v1.0 Rbacapplication https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/rbacapplication.md
Role management container for unified role definitions and role assignments for
| [List transitive role assignments](../api/rbacapplication-list-transitiveroleassignments.md) | [unifiedRoleAssignment](unifiedroleassignment.md) collection | Get direct and transitive unifiedRoleAssignments assigned to a specific principal. Specifying principalId is required. | | [Create role definition](../api/rbacapplication-post-roledefinitions.md) | [unifiedRoleDefinition](unifiedroledefinition.md) | Create a new unifiedRoleDefinition by posting to the roleDefinitions collection. | | [List role definitions](../api/rbacapplication-list-roledefinitions.md) | [unifiedRoleDefinition](unifiedroledefinition.md) collection | Get a unifiedRoleDefinition object collection. |
-| [roleSchedules](../api/rbacapplication-roleschedules.md) | [unifiedRoleScheduleBase](unifiedroleschedulebase.md) collection | Function to retrieve a collection of unifiedRoleScheduleBase objects. |
-| [roleScheduleInstances](../api/rbacapplication-rolescheduleinstances.md) | [unifiedRoleScheduleInstanceBase](unifiedrolescheduleinstancebase.md) collection | Function to retrieve a collection of unifiedRoleScheduleInstanceBase objects. |
+| [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. |
## Properties
v1.0 Sectiongroup https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sectiongroup.md
The following JSON representation shows the resource type.
| Method | Return Type |Description| |:|:--|:-|
-|[Get section group](../api/sectiongroup-get.md) | [sectionGroup](sectiongroup.md) |Read the properties and relationships of the section group.|
-|[Create section group](../api/sectiongroup-post-sectiongroups.md) |[sectionGroup](sectiongroup.md)| Create a section group by posting to the sectionGroups collection in the specified section group.|
-|[List section groups](../api/sectiongroup-list-sectiongroups.md) |[sectionGroup](sectiongroup.md) collection| Get collection of section groups 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/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.|
|[List sections](../api/sectiongroup-list-sections.md) |[onenoteSection](onenotesection.md) collection| Get a collection of sections 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.|
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Security Alert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-alert.md
Security providers create an alert in the system when they detect a threat. Micr
## Methods |Method|Return type|Description| |:|:|:|
-|[List alerts_v2](../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 alert](../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 alert](../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 for alert](../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.|
+|[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.|
## Properties |Property|Type| Description|
v1.0 Shared https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/shared.md
Title: Shared
+ Title: shared resource type
-description: The Shared resource indicates a DriveItem has been shared with others.
Previously updated : 09/10/2017
+description: Indicates that a drive item has been shared with others.
ms.localizationpriority: medium doc_type: resourcePageType
-# Shared resource type
+# shared resource type
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The **Shared** resource indicates a DriveItem has been shared with others.
-The resource includes information about how the item is shared.
+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 has been 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. |
## JSON representation
If a [**Driveitem**](driveitem.md) has a non-null **shared** facet, the item has
} ```
-## Properties
-
-| Property | Type | Description
-| :- |:|:-
-| owner | [IdentitySet](identityset.md) | The identity of the owner of the shared item. Read-only.
-| scope | String | Indicates the scope of how the item is shared: `anonymous`, `organization`, or `users`. 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 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. |
-
-## Remarks
-
-For more information about the facets on a **driveItem**, see [**driveItem**](driveitem.md).
- <!-- { "type": "#page.annotation",
v1.0 Teamsapp https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamsapp.md
Users can see these apps in the Microsoft Teams Store, and these apps can be ins
|[Publish apps to catalog](../api/teamsapp-publish.md) | [teamsApp](teamsapp.md) | Upload an app to your organization's app catalog.| |[Update app in catalog](../api/teamsapp-update.md) | [teamsApp](teamsapp.md) | Update an app in your organization's app catalog.| |[Delete app from catalog](../api/teamsapp-delete.md) | None | Remove an app from your organization's app catalog.|
-|[Get bot associated with app in catalog](../api/teamworkbot-get.md) | [teamworkbot](teamworkbot.md) | Get the bot associated with the Teams app.|
+|[Get associated bot](../api/teamworkbot-get.md) | [teamworkbot](teamworkbot.md) | Get the bot associated with the Teams app.|
## Properties
v1.0 Teamsasyncoperation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamsasyncoperation.md
When the request completes successfully, the status will be "succeeded" and the
| Property | Type | Description | |:|:--|:-|
-|id|string |Unique operation id.|
-|operationType|[teamsAsyncOperationType](teamsasyncoperationtype.md) |Denotes the type of operation being described. |
+|attemptsCount|Int32|Number of times the operation was attempted before being marked successful or failed.|
|createdDateTime|DateTimeOffset |Time when the operation was created.|
-|status|[teamsAsyncOperationStatus](teamsasyncoperationstatus.md)| Operation status.|
+|error|[operationError](operationerror.md)|Any error that causes the async operation to fail.|
+|id|string |Unique operation ID.|
|lastActionDateTime|DateTimeOffset |Time when the async operation was last updated.|
-|attemptsCount|Int32|Number of times the operation was attempted before being marked successful or failed.|
-|targetResourceId|guid |The ID of the object that's created or modified as result of this async operation, typically a [team](../resources/team.md).|
+|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).|
|targetResourceLocation|string|The location of the object that's created or modified as result of this async operation. This URL should be treated as an opaque value and not parsed into its component paths.|
-|error|[operationError](operationerror.md)|Any error that causes the async operation to fail.|
## JSON representation
-The following is a JSON representation of the resource.
+The following JSON representation shows the resource type.
<!-- { "blockType": "resource",
The following is a JSON representation of the resource.
```json {
- "id": "string",
- "operationType": "string",
- "createdDateTime": "string (timestamp)",
- "status": "string",
- "lastActionDateTime": "string (timestamp)",
- "attemptsCount": "Integer",
- "targetResourceId": "string",
- "targetResourceLocation": "string",
- "error": null
+ "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"
} ```
v1.0 Trustframeworkkeyset https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/trustframeworkkeyset.md
Inherits from [entity](../resources/entity.md).
|[Generate key](../api/trustframeworkkeyset-generatekey.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Generate a key in keyset.| |[Upload secret](../api/trustframeworkkeyset-uploadsecret.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Upload a string based secret.| |[Get active key](../api/trustframeworkkeyset-getactivekey.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Get currently active key in the keyset.|
-|[Upload certificate](../api/trustframeworkkeyset-uploadcertificate.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Upload a X.509 certificate.|
-|[uploadPkcs12](../api/trustframeworkkeyset-uploadpkcs12.md)|[trustFrameworkKey](../resources/trustframeworkkey.md)|Upload a PKCS12 format certificate.|
+|[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.|
## Properties |Property|Type|Description|
v1.0 Virtualeventregistration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventregistration.md
Title: "virtualEventRegistration resource type"
-description: "Represents an attendee's registration record of a virtual event."
-
+description: "Represents a registrant's registration record of a virtual event."
+ ms.localizationpriority: medium doc_type: resourcePageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents an attendee's registration record for a [virtualEventWebinar](../resources/virtualeventwebinar.md).
+Represents a registrant's registration record for a [virtualEvent](../resources/virtualevent.md).
+
+Currently, only [virtualEventWebinar](../resources/virtualeventwebinar.md) is supported.
Inherits from [entity](../resources/entity.md).
Inherits from [entity](../resources/entity.md).
|Method|Return type|Description| |:|:|:| |[List](../api/virtualeventregistration-list.md)|[virtualEventRegistration](../resources/virtualeventregistration.md) collection|Get a list of all [registration records](../resources/virtualeventregistration.md) of a [webinar](../resources/virtualeventwebinar.md).|
+|[Create](../api/virtualeventregistration-post.md)|None|Create a registrant's [registration record](../resources/virtualeventregistration.md) for a [webinar](../resources/virtualeventwebinar.md).|
|[Get](../api/virtualeventregistration-get.md)|[virtualEventRegistration](../resources/virtualeventregistration.md)|Get the properties and relationships of a [virtualEventRegistration](../resources/virtualeventregistration.md) object.|
+|[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).|
+ ## Properties
Inherits from [entity](../resources/entity.md).
|registrationQuestionAnswers|[virtualEventRegistrationQuestionAnswer](../resources/virtualeventregistrationquestionanswer.md) collection|The registrant's answer to the registration questions.| |status|[virtualEventAttendeeRegistrationStatus](#virtualeventattendeeregistrationstatus-values)|Registration status of the registrant. Read-only. | |userId|String|The registrant's ID in Microsoft Entra ID. Only appears when the registrant is registered in Microsoft Entra ID.|
+|preferredTimezone|String|The registrant's time zone details.|
+|preferredLanguage|String|The registrant's preferred language.|
### virtualEventAttendeeRegistrationStatus values
The following JSON representation shows the resource type
"registrationDateTime": "String (timestamp)", "registrationQuestionAnswers": [{"@odata.type": "microsoft.graph.virtualEventRegistrationQuestionAnswer"}], "status": "String",
- "userId": "String"
+ "userId": "String",
+ "preferredTimezone": "String",
+ "preferredLanguage": "String"
} ```
v1.0 Virtualeventregistrationconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventregistrationconfiguration.md
Inherits from [entity](../resources/entity.md).
|Relationship|Type|Description| |:|:|:|
-|questions|[virtualEventRegistrationQuestion](../resources/virtualeventregistrationquestion.md) collection|Registration questions.|
+|questions|[virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md) collection|Registration questions.|
## JSON representation
v1.0 Virtualeventregistrationcustomquestion https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventregistrationcustomquestion.md
+
+ 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"
+}
+```
v1.0 Virtualeventregistrationpredefinedquestion https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventregistrationpredefinedquestion.md
+
+ 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"
+}
+```
v1.0 Virtualeventregistrationquestionanswer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventregistrationquestionanswer.md
Title: "virtualEventRegistrationQuestionAnswer resource type"
-description: "Information about registration question answer of a virtual event."
-
+description: "Represents an answer or answers to a registration question of a virtual event."
+ ms.localizationpriority: medium doc_type: resourcePageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents one or more answers to a [virtualEventRegistrationQuestion](../resources/virtualeventregistrationquestion.md).
+Represents an answer or answers to either a [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) or a [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md).
## Properties |Property|Type|Description| |:|:|:|
-|booleanValue|Boolean|Boolean answer of the [virtualEventRegistrationQuestion](../resources/virtualeventregistrationquestion.md). Only appears when **answerInputType** is `boolean`. |
+|booleanValue|Boolean|Boolean answer to the [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md). Only appears when **answerInputType** is `boolean`. |
|displayName|String|Display name of the registration question.|
-|multiChoiceValues|String collection|Collection of text answer of the [virtualEventRegistrationQuestion](../resources/virtualeventregistrationquestion.md). Only appears when **answerInputType** is `multiChoice`.|
-|questionId|String|**id** of the [virtualEventRegistrationQuestion](../resources/virtualeventregistrationquestion.md).|
-|value|String|Text answer of the [virtualEventRegistrationQuestion](../resources/virtualeventregistrationquestion.md). Appears when **answerInputType** is `text`, `multilineText` or `singleChoice`.|
+|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`.|
## JSON representation
v1.0 Virtualeventregistrationquestionbase https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventregistrationquestionbase.md
+
+ Title: "virtualEventRegistrationQuestionBase resource type"
+description: "The abstract base type for a virtual event registration question."
+
+ms.localizationpriority: medium
+
+toc. Title: Virtual event registration question
++
+# virtualEventRegistrationQuestionBase resource type
+
+Namespace: microsoft.graph
++
+The abstract base type for a virtual event registration question.
+
+Base type of [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) and [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md).
+
+Inherits from [entity](../resources/entity.md).
+
+> [!TIP]
+> This is an abstract type and can't be used directly. Use the derived types [virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) and [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md) instead.
+
+## Methods
+
+|Method|Return type|Description|
+|:|:|:|
+|[List](../api/virtualeventregistrationconfiguration-list-questions.md)|[virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) collection or [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md) collection|Get a list of all [registration](../resources/virtualeventregistration.md) questions for a [webinar](../resources/virtualeventwebinar.md).|
+|[Create](../api/virtualeventregistrationconfiguration-post-questions.md)|[virtualEventRegistrationCustomQuestion](../resources/virtualeventregistrationcustomquestion.md) object or [virtualEventRegistrationPredefinedQuestion](../resources/virtualeventregistrationpredefinedquestion.md) object|Create a [registration](../resources/virtualeventregistration.md) question for a [webinar](../resources/virtualeventwebinar.md).|
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Display name of the registration question.|
+|id|String|Unique identifier of the registration question. Inherited from [entity](../resources/entity.md).|
+|isRequired|Boolean| Indicates whether an answer to the question is required. The default value is `false`.|
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.virtualEventRegistrationQuestionBase",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.virtualEventRegistrationQuestionBase",
+ "displayName": "String",
+ "id": "String (identifier)",
+ "isRequired": "Boolean"
+}
+```
v1.0 Virtualeventwebinar https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventwebinar.md
Inherits from [virtualEvent](../resources/virtualevent.md).
| [Create](../api/virtualeventsroot-post-webinars.md) | [virtualEventWebinar](../resources/virtualeventwebinar.md) | Create a [virtualEventWebinar](../resources/virtualeventwebinar.md) object. | | [Get](../api/virtualeventwebinar-get.md) | [virtualEventWebinar](../resources/virtualeventwebinar.md) | Read the properties and relationships of a [virtualEventWebinar](../resources/virtualeventwebinar.md) object. | | [Update](../api/virtualeventwebinar-update.md) | [virtualEventWebinar](../resources/virtualeventwebinar.md) | Update the properties of a [virtualEventWebinar](../resources/virtualeventwebinar.md) object. |
+| [Publish](../api/virtualeventwebinar-publish.md) | None | Publish a [virtualEventWebinar](../resources/virtualeventwebinar.md). |
+| [Cancel](../api/virtualeventwebinar-cancel.md) | None | Cancel a [virtualEventWebinar](../resources/virtualeventwebinar.md). |
| [List in organization](../api/virtualeventsroot-list-webinars.md) | [virtualEventWebinar](../resources/virtualeventwebinar.md) collection | Get the list of all [virtualEventWebinar](../resources/virtualeventwebinar.md) objects created in the tenant. | | [List by user role](../api/virtualeventwebinar-getbyuserrole.md) | [virtualEventWebinar](../resources/virtualeventwebinar.md) collection | Get a **virtualEventWebinar** collection where the signed-in user is either the organizer or a co-organizer. | | [List by user ID and role](../api/virtualeventwebinar-getbyuseridandrole.md) | [virtualEventWebinar](../resources/virtualeventwebinar.md) collection | Get a **virtualEventWebinar** collection where the specified user is either the organizer or a co-organizer. |
v1.0 Virtualeventwebinarregistrationconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventwebinarregistrationconfiguration.md
Currently, the **virtualEventWebinarRegistrationConfiguration** resource inherit
|:|:|:| | registrationWebUrl | String | Registration portal URL of the webinar. Inherited from [virtualEventRegistrationConfiguration](../resources/virtualeventregistrationconfiguration.md). |
+## Relationships
+
+|Relationship|Type|Description|
+|:|:|:|
+| questions | [virtualEventRegistrationQuestionBase](../resources/virtualeventregistrationquestionbase.md) collection | Registration questions. |
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Windowsupdates Operationalinsightsconnection https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/windowsupdates-operationalinsightsconnection.md
Inherits from [resourceConnection](../resources/windowsupdates-resourceconnectio
|[List](../api/adminwindowsupdates-list-resourceconnections-operationalinsightsconnection.md)|[microsoft.graph.windowsUpdates.operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md) collection|Get a list of the [operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md) objects and their properties.| |[Create](../api/adminwindowsupdates-post-resourceconnections-operationalinsightsconnection.md)|[microsoft.graph.windowsUpdates.operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md)|Create a new [operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md) object.| |[Get](../api/windowsupdates-operationalinsightsconnection-get.md)|[microsoft.graph.windowsUpdates.operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md)|Read the properties and relationships of an [operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md) object.|
-|[Delete operationalInsightsConnection](../api/windowsupdates-operationalinsightsconnection-delete.md)|None|Delete an [operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md) object.|
+|[Delete operational insights connection](../api/windowsupdates-operationalinsightsconnection-delete.md)|None|Delete an [operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md) object.|
## Properties |Property|Type|Description|
v1.0 Workbookchart https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbookchart.md
Represents a chart object in a workbook.
| Method | Return Type |Description| |:|:--|:-|
-|[Get chart](../api/chart-get.md) | [workbookChart](workbookchart.md) |Read properties and relationships of chart object.|
-|[Create ChartSeries](../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.|
-|[Update chart](../api/chart-update.md) | [workbookChart](workbookchart.md) |Update Chart 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 image](../api/chart-image.md)|Image base64 encoded string|Renders the chart as a base64-encoded image by scaling the chart to fit the specified dimensions.|
-|[Delete chart](../api/chart-delete.md)|None|Deletes the chart object.|
|[Reset data](../api/chart-setdata.md)|None|Resets the source data for the chart.| |[Set position data](../api/chart-setposition.md)|None|Positions the chart relative to cells on the worksheet.|
-|[List charts](../api/chart-list.md) | [workbookChart](workbookchart.md) collection |Get chart object collection. |
-|[Itemat](../api/chartcollection-itemat.md)|[workbookChart](workbookchart.md)|Gets a chart based on its position in the collection.|
-|[Add chart](../api/chartcollection-add.md)|[workbookChart](workbookchart.md)|Creates a new chart.|
+|[Get chart at position](../api/chartcollection-itemat.md)|[workbookChart](workbookchart.md)|Gets a chart based on its position in the collection.|
+ ## Properties | Property | Type |Description|
v1.0 Workbooknameditem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workbooknameditem.md
Represents a defined name for a range of cells or value. Names can be primitive
| Method | Return Type |Description| |:|:--|:-|
-|[Add](../api/nameditem-add.md)|[workbookNamedItem](workbooknameditem.md)|Add a new name to the collection of the given scope.|
-|[AddFormulaLocal](../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](../api/nameditem-list.md) | [workbookNamedItem](workbooknameditem.md) collection |Get a collection of **namedItem** objects. |
|[Get](../api/nameditem-get.md) | [workbookNamedItem](workbooknameditem.md) |Read properties and relationships of **namedItem** object.|
+|[Add](../api/nameditem-add.md)|[workbookNamedItem](workbooknameditem.md)|Add a new name to the collection of the given scope.|
|[Update](../api/nameditem-update.md) | [workbookNamedItem](workbooknameditem.md) |Update a **namedItem** object. |
-|[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.|
-|[List](../api/nameditem-list.md) | [workbookNamedItem](workbooknameditem.md) collection |Get a collection of **namedItem** objects. |
| [Delete](../api/nameditem-delete.md) | None | Delete a [workbookNamedItem](workbooknameditem.md) object. |
+|[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.|
## Properties | Property | Type |Description|
v1.0 Application Upsert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/application-upsert.md
PATCH /applications(uniqueName='{uniqueName}')
## Request headers | Name | Description| |:--|:-|
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | | Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. |
v1.0 Attachment Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/attachment-delete.md
DELETE /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/attachments/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Attachment Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/attachment-get.md
Use `$expand` to get the properties of an item attachment (contact, event, or me
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Authenticationcombinationconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationcombinationconfiguration-update.md
doc_type: apiPageType
# Update authenticationCombinationConfiguration Namespace: microsoft.graph
-Update the properties of an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object. In use, only [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) may be updated as they're the only type of [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) that may be created.
+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)
+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /identity/conditionalAccess/authenticationStrength/policies/{authenticatio
|Property|Type|Description| |:|:|:|
-|appliesToCombinations|authenticationMethodModes collection|The combinations to which this configuration applies. The only possible value for fido2combinationConfigurations is `fido2`. Required.|
--
+|appliesToCombinations|authenticationMethodModes collection|The combinations where this configuration applies. For **fido2combinationConfigurations** use `"fido2"`, for **x509certificatecombinationconfiguration** use `"x509CertificateSingleFactor"` or `"x509CertificateMultiFactor"`. Required.|
## Response
v1.0 Authenticationstrengthpolicy List Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationstrengthpolicy-list-combinationconfigurations.md
doc_type: apiPageType
# List combinationConfigurations Namespace: microsoft.graph
-Get the [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) objects for an [authentication strength policy](../resources/authenticationstrengthpolicy.md). authenticationCombinationConfiguration represents requirements placed on specific authentication method combinations that require specified variants of those authentication methods to be used when authenticating. Currently, only [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) objects are supported.
+Get the [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) objects for an [authentication strength policy](../resources/authenticationstrengthpolicy.md). The objects can be of one or more of the following derived types:
+* [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md)
+* [x509certificatecombinationconfiguration](../resources/x509certificatecombinationconfiguration.md)
-authenticationCombinationConfiguration objects are supported only for custom authentication strengths.
+**authenticationCombinationConfiguration** objects are supported only for custom authentication strengths.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
v1.0 Authenticationstrengthpolicy Post Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationstrengthpolicy-post-combinationconfigurations.md
Title: "Create authenticationCombinationConfiguration"
-description: "Create a new authenticationCombinationConfiguration object. In use, only fido2combinationConfigurations may be created, and these may only be created for custom authentication strength policies."
+description: "Create a new authenticationCombinationConfiguration object."
ms.localizationpriority: medium
doc_type: apiPageType
-# Create combinationConfiguration
+# Create authenticationCombinationConfiguration
Namespace: microsoft.graph
-Create a new authenticationCombinationConfiguration object. In use, only [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) may be created, and these may only be created for custom authentication strength policies.
+Create a new authenticationCombinationConfiguration object which can be of one of the following derived types:
+* [fido2combinationConfiguration](../resources/fido2combinationconfiguration.md)
+* [x509certificatecombinationconfiguration](../resources/x509certificatecombinationconfiguration.md)
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
You can specify the following properties when creating an **authenticationCombin
|Property|Type|Description| |:|:|:|
-|appliesToCombinations|authenticationMethodModes collection|The combinations to which this configuration applies. The only possible value for fido2combinationConfigurations is `fido2`. Required.|
-
+|appliesToCombinations|authenticationMethodModes collection|The combinations where this configuration applies. For **fido2combinationConfigurations** use `"fido2"`, for **x509certificatecombinationconfiguration** use `"x509CertificateSingleFactor"` or `"x509CertificateMultiFactor"`. Required.|
## Response
-If successful, this method returns a `201 Created` response code and a [fido2CombinationConfiguration](../resources/fido2CombinationConfiguration.md) object in the response body.
+If successful, this method returns a `201 Created` response code and an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object which can be a [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) or an [x509certificatecombinationconfiguration](../resources/x509certificatecombinationconfiguration.md) object in the response body.
## Examples
-### Request
+### Example 1: Create a fido2combinationConfiguration object
+
+#### Request
The following example shows a request. # [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "create_authenticationcombinationconfiguration_from_"
+ "name": "create_authenticationcombinationconfiguration_fido2CombinationConfiguration"
} --> ``` http
-POST https://graph.microsoft.com/v1.0/identity/conditionalAccess/authenticationStrength/policies/8313edec-d6af-483f-87b8-ec7cccfd2ab4/combinationConfigurations
+POST https://graph.microsoft.com/v1.0/identity/conditionalAccess/authenticationStrength/policies/{authenticationStrengthPolicyId}//combinationConfigurations
Content-Type: application/json Content-length: 130
Content-length: 130
-### Response
+#### Response
The following example shows the response. >**Note:** The response object shown here might be shortened for readability. <!-- {
Content-Type: application/json
} ```
+### Example 2: Create a x509CertificateCombinationConfiguration object
+
+#### Request
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_authenticationcombinationconfiguration_x509CertificateCombinationConfiguration"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/identity/conditionalAccess/authenticationStrength/policies/{authenticationStrengthPolicyId}/combinationConfigurations
+
+{
+ "@odata.type": "#microsoft.graph.x509CertificateCombinationConfiguration",
+ "allowedIssuerSkis": [
+ "9A4248C6AC8C2931AB2A86537818E92E7B6C97B6"
+ ],
+ "allowedPolicyOIDs": [],
+ "appliesToCombinations": [
+ "x509CertificateSingleFactor "
+ ]
+}
+```
+
+#### Response
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.authenticationCombinationConfiguration"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.x509CertificateCombinationConfiguration",
+ "id" : "96cb1a17-e45e-4b4f-8b4b-4a9490d63d66",
+ "allowedIssuerSkis": [
+ "9A4248C6AC8C2931AB2A86537818E92E7B6C97B6"
+ ],
+ "allowedPolicyOIDs": [],
+ "appliesToCombinations": [
+ "x509CertificateSingleFactor "
+ ]
+}
+```
+
v1.0 Calendar Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/calendar-delete.md
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}
## Request headers | Name | Type | Description| |:|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Calendar Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/calendar-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Calendar Getschedule https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/calendar-getschedule.md
POST /users/{id|userPrincipalName}/calendar/getSchedule
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity, which is application/json. Required. | | Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. |
v1.0 Calendar List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/calendar-list-calendarview.md
This method also supports some of the [OData Query Parameters](/graph/query-para
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | ## Request body
v1.0 Calendar List Events https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/calendar-list-events.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | ## Request body
v1.0 Calendargroup Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/calendargroup-delete.md
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Calendargroup Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/calendargroup-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Calendargroup List Calendars https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/calendargroup-list-calendars.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Channel Archive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-archive.md
+
+ Title: "channel: archive"
+description: "Archive a channel in a team."
+
+ms.localizationpriority: medium
+++
+# channel: archive
+
+Namespace: microsoft.graph
+
+Archive a [channel](../resources/channel.md) in a team. When a channel is archived, users can't send new messages or react to existing messages in the channel, edit the channel settings, or make other changes to the channel.
+
+You can delete an archived channel or add and remove members from it. If you archive a team, its channels are also archived.
+
+Archiving is an asynchronous operation; a channel is archived after the asynchronous archiving operation completes successfully, which might occur after the response returns.
+
+A channel without an owner or that belongs to a [group](../resources/group.md) that has no owner, can't be archived.
+
+To restore a channel from its archived state, use the [channel: unarchive](channel-unarchive.md) method. A channel canΓÇÖt be archived or unarchived if its team is archived.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | ChannelSettings.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | ChannelSettings.ReadWrite.All |
+
+> **Note**: This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't members of.
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /teams/{team-id}/channels/{channel-id}/archive
+POST /groups/{team-id}/team/channels/{channel-id}/archive
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+| Content-Type | application/json. Optional. |
+
+## Request body
+
+In the request body, you can optionally provide a JSON object with the following parameter.
+
+| Parameter | Type |Description|
+|:|:--|:-|
+|shouldSetSpoSiteReadOnlyForMembers|Boolean|Defines whether to set permissions for channel members to read-only on the SharePoint Online site associated with the team. If you set it to `false` or omit the parameter, this step is skipped.|
+
+The following example shows the request body with **shouldSetSpoSiteReadOnlyForMembers** set to `true`.
+
+```json
+{
+ "shouldSetSpoSiteReadOnlyForMembers": true
+}
+```
+
+## Response
+
+If archiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header that specifies the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle the archiving of the channel in a team. Check the status of the archiving operation by making a GET request to this location.
+
+## Examples
+
+### Example 1: Archive a channel
+
+The following example shows a request to archive a channel.
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "archive_channel",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/archive
+```
+
+#### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "name": "archive_channel"
+}-->
+```http
+HTTP/1.1 202 Accepted
+Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba
+Content-Type: text/plain
+Content-Length: 0
+```
+
+### Example 2: Archive a channel when the team is archived
+
+The following example shows a request to archive a channel that fails because the team is archived; the team must be active to archive or unarchive a channel.
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "archive_channel_on_archived_team",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/archive
+```
+
+#### Response
+
+The following example shows the `400 Bad Request` response code with a corresponding error message.
+
+<!-- {
+ "blockType": "response",
+ "name": "archive_channel_on_archived_team",
+ "@odata.type": "microsoft.graph.publicError",
+ "truncated": true
+}-->
+```http
+http/1.1 400 Bad Request
+Content-Type: application/json
+Content-Length: 193
+
+{
+ "error": {
+ "code": "BadRequest",
+ "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
+ "innerError": {
+ "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
+ "code": "Unknown",
+ "innerError": {},
+ "date": "2023-12-11T04:26:35",
+ "request-id": "8f897345980-f6f3-49dd-83a8-a3064eeecdf8",
+ "client-request-id": "50a0er33-4567-3f6c-01bf-04d144fc8bbe"
+ }
+ }
+}
+```
v1.0 Channel Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-get.md
Content-type: application/json
"createdDateTime": "2020-05-27T19:22:25.692Z", "displayName": "General", "description": "AutoTestTeam_20210311_150740.2550_fim3udfdjen9",
- "membershipType": "standard"
+ "membershipType": "standard",
+ "isArchived": false
} ```
v1.0 Channel List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-list.md
Content-type: application/json
"createdDateTime": "2020-05-27T19:22:25.692Z", "displayName": "General", "description": "AutoTestTeam_20210311_150740.2550_fim3udfdjen9",
- "membershipType": "standard"
+ "membershipType": "standard",
+ "isArchived": false
} ] }
Content-type: application/json
"createdDateTime": "2020-05-27T19:22:25.692Z", "displayName": "General", "description": "test private team",
- "membershipType": "private"
+ "membershipType": "private",
+ "isArchived": false
} ] }
Content-length: 262
"email": "", "webUrl": "https://teams.microsoft.com/l/channel/19%3ALpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81%40thread.tacv2/shared%20channel-01?groupId=6a720ba5-7373-463b-bc9f-4cd04b5c6742&tenantId=df81db53-c7e2-418a-8803-0e68d4b88607", "membershipType": "shared",
- "moderationSettings": null
+ "moderationSettings": null,
+ "isArchived": false
} ] }
v1.0 Channel Post Messagereply https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-post-messagereply.md
POST /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Channel Unarchive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-unarchive.md
+
+ Title: "channel: unarchive"
+description: "Restore an archived channel in a team."
+ms.localizationpriority: medium
++++
+# channel: unarchive
+
+Namespace: microsoft.graph
+
+Restore an archived [channel](../resources/channel.md). Unarchiving restores the ability for users to send messages and edit the channel. Channels are archived via the [channel: archive](channel-archive.md) method.
+
+Unarchiving is an asynchronous operation; a channel is unarchived when the asynchronous unarchiving operation completes successfully, which might occur after this method responds.
+
+> **Note**: An archived channel that belongs to an archived team can't be unarchived. Unarchive the team before you unarchive the channel; otherwise, the request fails.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | ChannelSettings.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | ChannelSettings.ReadWrite.All |
+
+> **Note**: This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't a member of.
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /teams/{team-id}/channels/{channel-id}/unarchive
+POST /groups/{team-id}/team/channels/{channel-id}/unarchive
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If unarchiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header that specifies the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle the unarchiving of the channel in a team. Check the status of the unarchiving operation by making a GET request to this location.
+
+## Examples
+
+### Example 1: Unarchive a channel
+
+The following example shows a request to unarchive a channel.
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "unarchive_channel",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/unarchive
+```
+
+#### Response
+
+The following example shows the response.
+<!-- {
+ "blockType": "response",
+ "name": "unarchive_channel"
+}-->
+```http
+HTTP/1.1 202 Accepted
+Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba
+Content-Type: text/plain
+Content-Length: 0
+```
+
+### Example 2: Unarchive a channel when the team is archived
+
+The following example shows a request to unarchive a channel that fails because the team is archived; the team must be active to archive or unarchive a channel.
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "unarchive_channel_on_archived_team",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/unarchive
+```
+
+#### Response
+
+The following example shows the `400 Bad Request` response code with a corresponding error message.
+
+<!-- {
+ "blockType": "response",
+ "name": "unarchive_channel_on_archived_team",
+ "@odata.type": "microsoft.graph.publicError",
+ "truncated": true
+}-->
+```http
+http/1.1 400 Bad Request
+Content-Type: application/json
+Content-Length: 193
+
+{
+ "error": {
+ "code": "BadRequest",
+ "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
+ "innerError": {
+ "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
+ "code": "Unknown",
+ "innerError": {},
+ "date": "2023-12-11T04:26:35",
+ "request-id": "8f897345980-f6f3-49dd-83a8-a3064eeecdf8",
+ "client-request-id": "50a0er33-4567-3f6c-01bf-04d144fc8bbe"
+ }
+ }
+}
+```
v1.0 Chatmessage Post Replies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chatmessage-post-replies.md
POST /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |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 [message](../resources/chatmessage.md) object. Only the body property is mandatory. Other properties are optional.
v1.0 Cloudclipboarditem Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudclipboarditem-get.md
This method doesn't support the OData query parameters to customize the respone.
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Cloudclipboardroot List Items https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudclipboardroot-list-items.md
This method supports `$skipToken` [OData query parameters](/graph/query-paramete
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Prefer |odata.maxpagesize={x}. Optional. Specifies a preferred integer {x} page size for paginated results. Acceptable values are 1 to 200, inclusive. If not specified in the header, the default page size is 110. ## Request body
v1.0 Cloudpcauditevent Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcauditevent-get.md
GET /deviceManagement/virtualEndpoint/auditEvents/{id}
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Cloudpcauditevent Getauditactivitytypes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpcauditevent-getauditactivitytypes.md
GET /deviceManagement/virtualEndpoint/auditEvents/getAuditActivityTypes
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Cloudpconpremisesconnection Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpconpremisesconnection-delete.md
DELETE /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Cloudpconpremisesconnection Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpconpremisesconnection-get.md
This method supports `$select` OData query parameter to help customize the respo
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Cloudpconpremisesconnection Runhealthcheck https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpconpremisesconnection-runhealthcheck.md
POST /deviceManagement/virtualEndpoint/onPremisesConnections/{id}/runHealthCheck
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Cloudpconpremisesconnection Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/cloudpconpremisesconnection-update.md
PATCH /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required.| ## Request body
v1.0 Contact Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/contact-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Contactfolder Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/contactfolder-delete.md
DELETE /users/{id | userPrincipalName}/contactFolders/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Contactfolder Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/contactfolder-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Contactfolder Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/contactfolder-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Contactfolder List Childfolders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/contactfolder-list-childfolders.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Contactfolder List Contacts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/contactfolder-list-contacts.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Conversationmembers Add https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/conversationmembers-add.md
Namespace: microsoft.graph
Add multiple members in a single request to a [team](../resources/team.md). The response provides details about which memberships could and couldn't be created.
+> [!NOTE]
+> Sometimes it takes time to reflect the addition of a member after they are added. Users can use [change notifications](../resources/change-notifications-api-overview.md) to subscribe to notifications for membership changes in a particular team.
+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions
Content-Type: application/json
#### Response
-The following is the response.
+The following example shows the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Crosstenantaccesspolicy List Partners https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/crosstenantaccesspolicy-list-partners.md
Content-Type: application/json
} ] }
+ },
+ "tenantRestrictions": {
+ "usersAndGroups": {
+ "accessType": "blocked",
+ "targets": [
+ {
+ "target": "AllUsers",
+ "targetType": "user"
+ }
+ ]
+ },
+ "applications": {
+ "accessType": "blocked",
+ "targets": [
+ {
+ "target": "AllApplications",
+ "targetType": "application"
+ }
+ ]
+ }
} } ]
v1.0 Crosstenantaccesspolicyconfigurationdefault Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-get.md
Content-Type: application/json
{ "isMfaAccepted": false, "isCompliantDeviceAccepted": false,
- "isHybridAzureADJoinedDeviceAccepted": false,
+ "isHybridAzureADJoinedDeviceAccepted": false
}, "automaticUserConsentSettings": {
Content-Type: application/json
] } },
+ "tenantRestrictions": {
+ "usersAndGroups": {
+ "accessType": "blocked",
+ "targets": [
+ {
+ "target": "AllUsers",
+ "targetType": "user"
+ }
+ ]
+ },
+ "applications": {
+ "accessType": "blocked",
+ "targets": [
+ {
+ "target": "AllApplications",
+ "targetType": "application"
+ }
+ ]
+ }
+ },
"invitationRedemptionIdentityProviderConfiguration": { "primaryIdentityProviderPrecedenceOrder": [
v1.0 Crosstenantaccesspolicyconfigurationdefault Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-update.md
PATCH /policies/crossTenantAccessPolicy/default
| b2bDirectConnectInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your default configuration for users from other organizations accessing your resources via Microsoft Entra B2B direct connect. | | b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your default configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the default configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. |
+| 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. |
## Response
v1.0 Crosstenantaccesspolicyconfigurationpartner Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationpartner-get.md
Content-Type: application/json
} ] }
+ },
+ "tenantRestrictions": {
+ "usersAndGroups": {
+ "accessType": "blocked",
+ "targets": [
+ {
+ "target": "AllUsers",
+ "targetType": "user"
+ }
+ ]
+ },
+ "applications": {
+ "accessType": "blocked",
+ "targets": [
+ {
+ "target": "AllApplications",
+ "targetType": "application"
+ }
+ ]
+ }
} } ```
v1.0 Crosstenantaccesspolicyconfigurationpartner Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationpartner-update.md
PATCH /policies/crossTenantAccessPolicy/partners/{id}
| b2bDirectConnectInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users from other organizations accessing your resources via Microsoft Entra B2B direct connect. | | b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the partner-specific configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. |
+| 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. |
## Response
The following example shows the response.
``` http HTTP/1.1 204 No Content ```+
+### Example 3: Configure tenant restrictions settings
+
+The following example shows how to configure tenant restrictions settings.
+
+#### Request
+
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_crosstenantaccesspolicyconfigurationpartner_tenantrestriction"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners/90e29127-71ad-49c7-9ce8-db3f41ea06f1
+Content-Type: application/json
+
+{
+ "tenantRestrictions": {
+ "usersAndGroups": {
+ "accessType": "allowed",
+ "targets": [
+ {
+ "target": "AllUsers",
+ "targetType": "user"
+ }
+ ]
+ },
+ "applications": {
+ "accessType": "allowed",
+ "targets": [
+ {
+ "target": "Office365",
+ "targetType": "application"
+ }
+ ]
+ }
+ }
+}
+```
+
+#### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Device Delete Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/device-delete-registeredusers.md
DELETE /devices/{id}/registeredUsers/{id}/$ref
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Device Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/device-get.md
This method supports the `$select` [OData query parameter](/graph/query-paramete
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Device List Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/device-list-registeredowners.md
Some queries are supported only when you use the **ConsistencyLevel** header set
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Device List Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/device-list-registeredusers.md
Some queries are supported only when you use the **ConsistencyLevel** header set
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Device Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/device-update.md
PATCH /devices(deviceId='{deviceId}')
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Directoryobject Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/directoryobject-get.md
GET /directoryObjects/{id}
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Directoryrole Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/directoryrole-get.md
This method supports the `$select` [OData query parameter](/graph/query-paramete
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Directoryrole List Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/directoryrole-list-members.md
This method supports the `$select` [OData query parameter](/graph/query-paramete
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Directoryroletemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/directoryroletemplate-get.md
This method does **not** support the [OData Query Parameters](/graph/query-param
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Directoryroletemplate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/directoryroletemplate-list.md
This method does **not** support the [OData Query Parameters](/graph/query-param
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationclass List Modules https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationclass-list-modules.md
The available `$expand` option for this method is: `resources`.
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationclass Post Module https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationclass-post-module.md
POST /education/classes/{id}/modules
| Header | Value | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Educationmodule Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmodule-delete.md
DELETE /education/classes/{id}/modules/{id}
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationmodule Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmodule-get.md
This method supports the `$select` OData query parameter to help customize the r
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationmodule List Resources https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmodule-list-resources.md
This method supports the `$expand` OData query parameter to help customize the r
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationmodule Pin https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmodule-pin.md
POST /education/classes/{id}/modules/{id}/pin
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationmodule Post Resources https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmodule-post-resources.md
POST /education/classes/{class-id}/modules/{module-id}/resources
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json | ## Request body
v1.0 Educationmodule Publish https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmodule-publish.md
POST /education/classes/{id}/modules/{id}/publish
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationmodule Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmodule-setupresourcesfolder.md
POST /education/classes/{classId}/modules/{moduleId}/setUpResourcesFolder
| Header | Value | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Educationmodule Unpin https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmodule-unpin.md
POST /education/classes/{id}/modules/{id}/unpin
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationmodule Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmodule-update.md
PATCH /education/classes/{class-id}/modules/{module-id}
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json | ## Request body
v1.0 Educationmoduleresource Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmoduleresource-delete.md
DELETE /education/classes/{class-id}/modules/{module-id}/resources/{resource-id}
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationmoduleresource Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmoduleresource-get.md
This method supports the `$select` OData query parameter to help customize the r
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationmoduleresource Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationmoduleresource-update.md
PATCH /education/classes/{class-id}/modules/{module-id}/resources/{resource-id}
| Header | Value | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json | ## Request body
v1.0 Educationsubmission Excuse https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationsubmission-excuse.md
POST /education/classes/{classId}/assignments/{assignmentId}/submissions/{submis
## Request headers | Header | Value | |:|:--|
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer | `include-unknown-enum-members`. Optional. | ## Request body
v1.0 Event Accept https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-accept.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Cancel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-cancel.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Decline https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-decline.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-delete.md
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Event Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-delta.md
includes the encoded, desired parameters.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. | | Prefer | string | {Time zone}. Optional, UTC assumed if absent.|
v1.0 Event Dismissreminder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-dismissreminder.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
<br/>
v1.0 Event Forward https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-forward.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header is not specified, the **body** property is returned in HTML format. Optional. |
v1.0 Event List Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-list-attachments.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Event List Instances https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-list-instances.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | ## Request body
v1.0 Event Post Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-post-attachments.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Snoozereminder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-snoozereminder.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Tentativelyaccept https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-tentativelyaccept.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/event-update.md
PATCH /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/
| Name | Type | Description | |:--|:-|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Eventmessage Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/eventmessage-delete.md
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Eventmessage Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/eventmessage-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Eventmessage List Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/eventmessage-list-attachments.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Eventmessage Post Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/eventmessage-post-attachments.md
POST /users/{id | userPrincipalName}/messages/{id}/attachments
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Eventmessage Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/eventmessage-update.md
PATCH /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed. Writable/Updatable properties are
v1.0 Group Get Event https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-get-event.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description | | :-- | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header isn't specified, the **body** property is returned in HTML format. Optional. |
v1.0 Group Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-get.md
For more information on OData query options, see [OData Query Parameters](/graph
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-list-calendarview.md
This method also supports some of the [OData Query Parameters](/graph/query-para
| Name | Type | Description | | :-- | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header isn't specified, the **body** property is returned in HTML format. Optional. |
v1.0 Group List Events https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-list-events.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header isn't specified, the **body** property is returned in HTML format. Optional. |
v1.0 Group List Owners https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-list-owners.md
Some queries are supported only when you use the **ConsistencyLevel** header set
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group List Photos https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-list-photos.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Update Event https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-update-event.md
PATCH /groups/{id}/calendar/events/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Update Thread https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-update-thread.md
PATCH /groups/{id}/threads/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-update.md
PATCH /groups/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Upsert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-upsert.md
PATCH /groups/(uniqueName='uniqueName')
| Name | Description | |:--|:|
-| Authorization | Bearer {token}. Required.|
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required.| | Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. |
v1.0 Identitycontainer Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitycontainer-post-identityproviders.md
Content-type: application/json
} ```
-### Example 2: Retrieves Apple identity provider (only for Azure AD B2C)
+### Example 2: Create Apple identity provider (only for Azure AD B2C)
#### Request
v1.0 Inferenceclassification List Overrides https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/inferenceclassification-list-overrides.md
GET /users/{id}/inferenceClassification/overrides
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Inferenceclassification Post Overrides https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/inferenceclassification-post-overrides.md
POST /users/{id}/inferenceClassification/overrides
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Inferenceclassificationoverride Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/inferenceclassificationoverride-delete.md
DELETE /users/{id}/inferenceClassification/overrides/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Inferenceclassificationoverride Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/inferenceclassificationoverride-update.md
PATCH /users/{id}/inferenceClassification/overrides/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 M365appsinstallationoptions Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/m365appsinstallationoptions-get.md
This method supports the `$select` [OData query parameter](/graph/query-paramete
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 M365appsinstallationoptions Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/m365appsinstallationoptions-update.md
PATCH /admin/microsoft365Apps/installationOptions
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Mailfolder Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/mailfolder-delete.md
DELETE /users/{id | userPrincipalName}/mailFolders/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Mailfolder Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/mailfolder-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Mailfolder List Childfolders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/mailfolder-list-childfolders.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Mailfolder List Messagerules https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/mailfolder-list-messagerules.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Mailfolder List Messages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/mailfolder-list-messages.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Message Createforward https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/message-createforward.md
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/createForwar
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content. | ## Request body
v1.0 Message Createreply https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/message-createreply.md
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/createReply
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required.|
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content. | | Prefer: outlook.timezone | string | Sets the timezone in the email thread to the desired format while replying to an email. Values can be any of the outlook [supportedTimeZones](outlookuser-supportedtimezones.md). If the header is not specified, by default UTC timezone is followed. Optional.|
v1.0 Message Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/message-delete.md
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Message Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/message-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Message Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/message-get.md
Use the `$value` parameter to get the MIME content of a message.
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.body-content-type | string | The format of the **body** and **uniqueBody** properties to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header is not specified, the **body** and **uniqueBody** properties are returned in HTML format. Optional. | ## Request body
v1.0 Message List Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/message-list-attachments.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Message Post Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/message-post-attachments.md
POST /users/{id | userPrincipalName}/mailFolders/{id}/childFolders/{id}/messages
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Message Send https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/message-send.md
POST /users/{id | userPrincipalName}/messages/{id}/send
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Length | number | 0. Required. | ## Request body
v1.0 Message Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/message-update.md
PATCH /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed. The following properties can be updated.
v1.0 Multitenantorganization Delete Tenants https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-delete-tenants.md
DELETE /tenantRelationships/multiTenantOrganization/tenants/{tenantId}
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Multitenantorganization Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-get.md
This method supports the `$select` OData query parameter to help customize the r
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Multitenantorganization List Tenants https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-list-tenants.md
This method supports the `$select` and `$filter` OData query parameters to help
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Multitenantorganization Post Tenants https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-post-tenants.md
POST /tenantRelationships/multiTenantOrganization/tenants
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Multitenantorganization Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-update.md
PATCH /tenantRelationships/multiTenantOrganization
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Multitenantorganizationidentitysyncpolicytemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationidentitysyncpolicytemplate-get.md
This method supports the `$select` OData query parameter to help customize the r
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Multitenantorganizationidentitysyncpolicytemplate Resettodefaultsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationidentitysyncpolicytemplate-resettodefaultsettings.md
POST /policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentity
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Multitenantorganizationidentitysyncpolicytemplate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationidentitysyncpolicytemplate-update.md
PATCH /policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentit
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Multitenantorganizationjoinrequestrecord Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationjoinrequestrecord-get.md
This method supports the `$select` OData query parameter to help customize the r
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Multitenantorganizationjoinrequestrecord Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationjoinrequestrecord-update.md
PATCH /tenantRelationships/multiTenantOrganization/joinRequest
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Multitenantorganizationmember Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationmember-get.md
This method supports the `$select` OData query parameter to help customize the r
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Multitenantorganizationmember Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationmember-update.md
PATCH /tenantRelationships/multiTenantOrganization/tenants/{tenantId}
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Multitenantorganizationpartnerconfigurationtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationpartnerconfigurationtemplate-get.md
This method supports the `$select` OData query parameter to help customize the r
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Multitenantorganizationpartnerconfigurationtemplate Resettodefaultsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationpartnerconfigurationtemplate-resettodefaultsettings.md
POST /policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerC
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Multitenantorganizationpartnerconfigurationtemplate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganizationpartnerconfigurationtemplate-update.md
PATCH /policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartner
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Notebook Copynotebook https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/notebook-copynotebook.md
POST /groups/{id}/onenote/notebooks/{id}/copyNotebook
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Notebook Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/notebook-get.md
Valid `expand` values for notebooks are `sections` and `sectionGroups`.
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Notebook Getnotebookfromweburl https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/notebook-getnotebookfromweburl.md
POST /sites/{id}/onenote/notebooks/GetNotebookFromWebUrl
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Notebook List Sectiongroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/notebook-list-sectiongroups.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Notebook List Sections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/notebook-list-sections.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Notebook Post Sectiongroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/notebook-post-sectiongroups.md
POST /sites/{id}/onenote/notebooks/{id}/sectionGroups
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Notebook Post Sections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/notebook-post-sections.md
POST /sites/{id}/onenote/notebooks/{id}/sections
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Oauth2permissiongrant Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/oauth2permissiongrant-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Oauth2permissiongrant Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/oauth2permissiongrant-post.md
POST /oauth2PermissionGrants
| Name | Type | Description | |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Oauth2permissiongrant Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/oauth2permissiongrant-update.md
PATCH /oauth2PermissionGrants/{id}
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Onenote List Notebooks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onenote-list-notebooks.md
Valid `expand` values for notebooks are `sections` and `sectionGroups`.
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Onenote List Pages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onenote-list-pages.md
The default response expands `parentSection` and selects the section's `id`, `di
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Onenote List Sectiongroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onenote-list-sectiongroups.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Onenote List Sections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onenote-list-sections.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Onenote Post Notebooks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onenote-post-notebooks.md
POST /sites/{id}/onenote/notebooks
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Onenote Post Pages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onenote-post-pages.md
POST /sites/{id}/onenote/pages
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `text/html` or `application/xhtml+xml` for the HTML content, including for the required "Presentation" part of multipart requests. Multipart requests use the `multipart/form-data; boundary=your-boundary` content type. | ## Request body
v1.0 Onenoteoperation Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onenoteoperation-get.md
None.
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Organization List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/organization-list.md
This method supports the `$select` [OData query parameter](/graph/query-paramete
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Outlookuser Supportedlanguages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/outlookuser-supportedlanguages.md
GET /users/{id|userPrincipalName}/outlook/supportedLanguages
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Outlookuser Supportedtimezones https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/outlookuser-supportedtimezones.md
GET /users/{id|userPrincipalName}/outlook/supportedTimeZones(TimeZoneStandard=mi
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Page Copytosection https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/page-copytosection.md
POST /groups/{id}/onenote/pages/{id}/copyToSection
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Page Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/page-delete.md
DELETE /sites/{id}/onenote/pages/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Response
v1.0 Page Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/page-get.md
The default response expands `parentSection` and selects the section's `id`, `na
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Page Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/page-update.md
PATCH /sites/{id}/onenote/pages/{id}/content
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Partners Billing Billedreconciliation Export https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/partners-billing-billedreconciliation-export.md
POST /reports/partners/billing/reconciliation/billed/export
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Partners Billing Billedusage Export https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/partners-billing-billedusage-export.md
POST /reports/partners/billing/usage/billed/export
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Partners Billing Manifest Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/partners-billing-manifest-get.md
This method doesn't support any OData query parameters to help customize the res
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Partners Billing Operation Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/partners-billing-operation-get.md
This method doesn't support any OData query parameters to help customize the res
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Partners Billing Unbilledusage Export https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/partners-billing-unbilledusage-export.md
POST /reports/partners/billing/usage/unbilled/export
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Profilephoto Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/profilephoto-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Projectrome Delete Activity https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/projectrome-delete-activity.md
DELETE /me/activities/{id}
|Name | Type | Description| |:-|:--|:--|
-|Authorization | string | Bearer {token}. Required.|
+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Projectrome Delete Historyitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/projectrome-delete-historyitem.md
DELETE /me/activities/{id}/historyItems/{id}
|Name | Type | Description| |:-|:--|:--|
-|Authorization | string | Bearer {token}. Required.|
+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Projectrome Get Activities https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/projectrome-get-activities.md
The following are some examples of supported queries with URL encoding:
|Name | Type | Description| |:-|:--|:--|
-|Authorization | string | Bearer {token}. Required.|
+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Projectrome Get Recent Activities https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/projectrome-get-recent-activities.md
The following are some examples of supported queries with URL encoding.
|Name | Type | Description| |:-|:--|:--|
-|Authorization | string | Bearer {token}. Required.|
+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Projectrome Put Activity https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/projectrome-put-activity.md
PUT /me/activities/{appActivityId}
| Name | Type | Description | |:--|:-|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Projectrome Put Historyitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/projectrome-put-historyitem.md
PUT /me/activities/{id}/historyItems/{id}
|Name | Type | Description| |:-|:--|:--|
-|Authorization | string | Bearer {token}. Required.|
+|Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Reportroot Getrelyingpartydetailedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/reportroot-getrelyingpartydetailedsummary.md
This method supports the `$filter` and `$orderby` OData query parameters to help
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Resource Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/resource-get.md
GET /sites/{id}/onenote/resources/{id}/content
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Search Acronym Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-acronym-delete.md
DELETE /search/acronyms/{acronymsId}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Search Acronym Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-acronym-get.md
This method supports the `select`, `expand`, `filter`, `orderBy`, `maxTop`, and
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Search Acronym Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-acronym-update.md
PATCH /search/acronyms/{acronymsId}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Search Bookmark Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-bookmark-delete.md
DELETE /search/bookmarks/{bookmarksId}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Search Bookmark Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-bookmark-get.md
This method supports the `select`, `expand`, `filter`, `orderBy`, `maxTop`, and
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Search Bookmark Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-bookmark-update.md
PATCH /search/bookmarks/{bookmarksId}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Search Qna Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-qna-delete.md
DELETE /search/qnas/{qnaId}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Search Qna Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-qna-get.md
This method supports the `select`, `expand`, `filter`, `orderBy`, `maxTop`, and
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Search Qna Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-qna-update.md
PATCH /search/qnas/{qnaId}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Search Searchentity List Acronyms https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-list-acronyms.md
This method supports the `select`, `expand`, `filter`, `orderBy`, `maxTop`, and
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Search Searchentity List Bookmarks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-list-bookmarks.md
This method supports the `select`, `expand`, `filter`, `orderBy`, `maxTop`, and
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Search Searchentity List Qnas https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-list-qnas.md
This method supports the `select`, `expand`, `filter`, `orderBy`, `maxTop`, and
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Search Searchentity Post Acronyms https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-post-acronyms.md
POST /search/acronyms
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Search Searchentity Post Bookmarks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-post-bookmarks.md
POST /search/bookmarks
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Search Searchentity Post Qnas https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/search-searchentity-post-qnas.md
POST /search/qnas
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Section Copytonotebook https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/section-copytonotebook.md
POST /groups/{id}/onenote/sections/{id}/copyToNotebook
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Section Copytosectiongroup https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/section-copytosectiongroup.md
POST /groups/{id}/onenote/sections/{id}/copyToSectionGroup
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Section Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/section-get.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Section List Pages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/section-list-pages.md
The default response expands `parentSection` and selects the section's `id`, `na
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Section Post Pages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/section-post-pages.md
POST /sites/{id}/onenote/sections/{id}/pages
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `text/html` or `application/xhtml+xml` for the HTML content, including for the required "Presentation" part of multipart requests. Multipart requests use the `multipart/form-data; boundary=your-boundary` content type. | ## Request body
v1.0 Sectiongroup Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sectiongroup-get.md
The default query expands `parentNotebook` and selects its `id`, `name`, and `se
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Sectiongroup List Sectiongroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sectiongroup-list-sectiongroups.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Sectiongroup List Sections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sectiongroup-list-sections.md
The default query expands `parentNotebook` and selects its `id`, `displayName`,
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Accept | string | `application/json` | ## Request body
v1.0 Sectiongroup Post Sectiongroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sectiongroup-post-sectiongroups.md
POST /sites/{id}/onenote/sectionGroups/{id}/sectionGroups
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Sectiongroup Post Sections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sectiongroup-post-sections.md
POST /sites/{id}/onenote/sectionGroups/{id}/sections
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | `application/json` | ## Request body
v1.0 Security Authoritytemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-authoritytemplate-get.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Categorytemplate Delete Subcategories https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-categorytemplate-delete-subcategories.md
DELETE /security/labels/categories/{categoryTemplateId}/subcategories/{subcatego
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Categorytemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-categorytemplate-get.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Categorytemplate List Subcategories https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-categorytemplate-list-subcategories.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Categorytemplate Post Subcategories https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-categorytemplate-post-subcategories.md
POST /security/labels/categories/{categoryTemplateId}/subcategories
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Security Citationtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-citationtemplate-get.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Departmenttemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-departmenttemplate-get.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Fileplanreferencetemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-fileplanreferencetemplate-get.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot Delete Authorities https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-delete-authorities.md
DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/authority
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot Delete Categories https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-delete-categories.md
DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryT
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot Delete Citations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-delete-citations.md
DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/citationT
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot Delete Departments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-delete-departments.md
DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/departmen
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot Delete Fileplanreferences https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-delete-fileplanreferences.md
DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/filePlanR
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot List Authorities https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-authorities.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot List Categories https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-categories.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot List Citations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-citations.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot List Departments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-departments.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot List Fileplanreferences https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-fileplanreferences.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot List Retentionlabel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-list-retentionlabel.md
For general information, see [OData query parameters](/graph/query-parameters).
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Labelsroot Post Authorities https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-authorities.md
POST /security/labels/authorities
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Security Labelsroot Post Categories https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-categories.md
POST /security/labels/categories
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Security Labelsroot Post Citations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-citations.md
POST /security/labels/citations
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Security Labelsroot Post Departments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-departments.md
POST /security/labels/departments
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Security Labelsroot Post Fileplanreferences https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-fileplanreferences.md
POST /security/labels/filePlanReferences
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Security Labelsroot Post Retentionlabel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-labelsroot-post-retentionlabel.md
POST /security/labels/retentionLabels
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Security Retentionlabel Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-retentionlabel-delete.md
DELETE /security/labels/retentionLabels/{retentionLabelId}
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Retentionlabel Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-retentionlabel-get.md
This method supports the expand OData query parameters to help customize the res
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Security Retentionlabel Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-retentionlabel-update.md
PATCH /security/labels/retentionLabels/{retentionLabelId}
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Security Subcategorytemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-subcategorytemplate-get.md
This method supports some of the OData query parameters to help customize the re
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|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.
v1.0 Serviceprincipal Upsert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/serviceprincipal-upsert.md
PATCH /servicePrincipals(appId='appId')
## Request headers | Name | Description| |:--|:-|
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | | Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. |
v1.0 Site Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/site-delta.md
This method also supports the `$select`, `$expand`, and `$top` [OData query para
|Header |Value | |-|-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Subscription Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/subscription-delete.md
DELETE /subscriptions/{subscription-id}
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Subscription Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/subscription-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Subscription List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/subscription-list.md
Most commonly, an application wants to retrieve subscriptions that it originally
### Advanced scenarios
-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, an administrator may want to see all subscriptions from all apps in their directory.
+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 might want to see all subscriptions from all apps in their directory.
For such scenarios, a delegated permission Subscription.Read.All is required. | Context of the calling app | Response contains | |:--|:- | | App is calling on behalf of the signed-in user (delegated permission). *The user is a non-admin*. <br/>-and-<br/>App has the permission Subscription.Read.All<br/><br/>Note: This applies to both personal Microsoft accounts and work/school accounts. | Subscriptions created by **any app** for the signed-in user only. |
-| App is calling on behalf of the signed-in user (delegated permission). *The user is an admin*.<br/>-and-<br/>App has the permission Subscription.Read.All<br/><br/>Note: This applies to work/school accounts only. | Subscriptions created by **any app** for **any user** in the 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 applies to work/school accounts only. | Subscriptions created by **any app** for **any user** in the directory.|
## HTTP request
This method doesn't support the [OData query parameters](/graph/query-parameters
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Subscription Post Subscriptions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/subscription-post-subscriptions.md
POST /subscriptions
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Subscription Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/subscription-update.md
PATCH /subscriptions/{id}
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronization List Jobs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronization-list-jobs.md
GET /servicePrincipals/{id}/synchronization/jobs/
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronization List Templates https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronization-list-templates.md
GET applications/{id}/synchronization/templates
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronization Post Jobs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronization-post-jobs.md
POST /servicePrincipals/{id}/synchronization/jobs/
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationjob Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationjob-delete.md
DELETE /servicePrincipals/{id}/synchronization/jobs/{jobId}/
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationjob Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationjob-get.md
GET /servicePrincipals/{id}/synchronization/jobs/{jobId}/
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationjob Pause https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationjob-pause.md
POST /servicePrincipals/{id}/synchronization/jobs/{jobId}/pause
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationjob Restart https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationjob-restart.md
POST /servicePrincipals(appId='{appId}')/synchronization/jobs/{jobId}/restart
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationjob Start https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationjob-start.md
POST /servicePrincipals/{id}/synchronization/jobs/{jobId}/start
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationschema Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationschema-delete.md
DELETE /applications/{id}/synchronization/templates/{templateId}/schema
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationschema Filteroperators https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationschema-filteroperators.md
GET /applications/{id}/synchronization/templates/{templateId}/schema/filterOpera
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationschema Functions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationschema-functions.md
GET /applications/{id}/synchronization/templates/{templateId}/schema/functions
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationschema Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationschema-get.md
GET /applications/{id}/synchronization/templates/{templateId}/schema
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationschema Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationschema-update.md
PUT /applications/{id}/synchronization/templates/{templateId}/schema
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationtemplate-get.md
GET servicePrincipals/{id}/synchronization/templates/{templateId}
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Synchronizationtemplate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationtemplate-update.md
PATCH applications/{id}/synchronization/templates/{templateId}
| Name | Type | Description| |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Team List Allchannels https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-list-allchannels.md
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and a collection of [channel](../resources/channel.md) objects in the response body. The response also includes the **@odata.id** property which can be used to access the channel and run other operations on the [channel](../resources/channel.md) object. > [!Note]
-> Currently, invoking the URL returned from the **@odata.id** property fails for cross-tenant shared channels. You can solve this issue if you remove the `/tenants/{tenant-id}` part from the URL before you call this API. For more details, see [Known issues with Microsoft Graph](https://developer.microsoft.com/en-us/graph/known-issues/?search=14971).
+> Currently, invoking the URL returned from the **@odata.id** property fails for cross-tenant shared channels. You can solve this issue if you remove the `/tenants/{tenant-id}` part from the URL before you call this API. For more information, see [Known issues with Microsoft Graph](https://developer.microsoft.com/en-us/graph/known-issues/?search=14971).
## Examples
Content-Type: application/json
"displayName": "General", "description": "AutoTestTeam_20210311_150740.2550_fim3udfdjen9", "membershipType": "standard",
- "tenantId": "b3246f44-b4gb-4627-96c6-25b18fa2c910"
+ "tenantId": "b3246f44-b4gb-4627-96c6-25b18fa2c910",
+ "isArchived": false
}, { "@odata.id": "https://graph.microsoft.com/v1.0/tenants/b3246f44-b4gb-5678-96c6-25b18fa2c910/teams/893075dd-5678-5634-925f-022c42e20265/channels/19:561fbdbbfca848a484gabdf00ce9dbbd@thread.tacv",
Content-Type: application/json
"createdDateTime": "2020-05-27T19:22:25.692Z", "displayName": "Shared channel from Contoso", "membershipType": "shared",
- "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910"
+ "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910",
+ "isArchived": false
} ] }
Content-Type: application/json
"createdDateTime": "2020-05-27T19:22:25.692Z", "displayName": "Shared channel from Contoso", "membershipType": "shared",
- "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910"
+ "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910",
+ "isArchived": false
} ] }
v1.0 Team Post Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-post-members.md
Namespace: microsoft.graph
Add a new [conversationMember](../resources/conversationmember.md) to a [team](../resources/team.md). > [!NOTE]
-> The **roles** property will be 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 should not have any values specified in the **roles** property.
+> * 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.
+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
In the request body, supply a JSON representation of the [conversationMember](..
If successful, this method returns a `201 Created` response code and a [conversationMember](../resources/conversationmember.md) object in the response body.
-For best results, stagger calls with a 2 second buffer.
+For best results, stagger calls with a 2-second buffer.
> [!NOTE] > The response code `404 Not Found` is returned when you attempt to add a disabled/blocked user.
v1.0 Tenantrelationship Put Multitenantorganization https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/tenantrelationship-put-multitenantorganization.md
PUT /tenantRelationships/multiTenantOrganization
## Request headers |Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Todotask Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/todotask-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Todotasklist Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/todotasklist-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 User Get Mailboxsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-get-mailboxsettings.md
This method supports some of the [OData Query Parameters](/graph/query-parameter
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 User List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-calendarview.md
This method also supports some of the [OData Query Parameters](/graph/query-para
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header is not specified, the **body** property is returned in HTML format. Optional. |
v1.0 User List Events https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-events.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header is not specified, the **body** property is returned in HTML format. Optional. |
v1.0 User List Messages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-messages.md
Failing to do this results in the following error:
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.body-content-type | string | The format of the **body** and **uniqueBody** properties to be returned in. Values can be "text" or "html". If the header is not specified, the **body** and **uniqueBody** properties are returned in HTML format. Optional. |
v1.0 User Post Messages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-post-messages.md
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Length | number | 0. Required. | | Content-Type | string | Nature of the data in the body of an entity. Required. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content. |
v1.0 User Sendmail https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-sendmail.md
POST /users/{id | userPrincipalName}/sendMail
| Name | Type | Description | |:--|:-|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content. | ## Request body
v1.0 User Update Mailboxsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-update-mailboxsettings.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, supply the values for the relevant properties that should be updated. Existing properties that are not included in the
v1.0 Virtualendpoint List Auditevents https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-list-auditevents.md
This method supports `$skiptoken`, `$top` and `$filter` OData query parameters t
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Virtualendpoint List Onpremisesconnections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-list-onpremisesconnections.md
This method supports `$select` and `$filter` OData query parameters to help cust
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Virtualendpoint Post Onpremisesconnections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualendpoint-post-onpremisesconnections.md
POST /deviceManagement/virtualEndpoint/onPremisesConnections
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required.| ## Request body
v1.0 Accessreviewhistoryinstance https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewhistoryinstance.md
Namespace: microsoft.graph
| Method | Return type | Description | |:|:|:| |[List](../api/accessreviewhistorydefinition-list-instances.md)|[accessReviewHistoryInstance](accessreviewhistoryinstance.md) collection| Retrieve a list of the [accessReviewHistoryInstance](accessreviewhistoryinstance.md) objects and their properties.|
-|[generateDownloadUri](../api/accessreviewhistoryinstance-generatedownloaduri.md)|[accessReviewHistoryDefinition](accessreviewhistorydefinition.md)|Generates a URI that can be used to retrieve the instance's review history data.|
+|[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.|
## Properties
v1.0 Accessreviewsv2 Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewsv2-overview.md
Title: "MOverview of access reviews APIs"
+ Title: "Overview of access reviews APIs"
description: "Use Microsoft Entra access reviews to configure one-time or recurring access reviews for attestation of a principal's access rights to Microsoft Entra resources." ms.localizationpriority: medium
v1.0 Authenticationcombinationconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationcombinationconfiguration.md
doc_type: resourcePageType
Namespace: microsoft.graph
-An authentication combination configuration sets restrictions on specific types, modes, and versions of an authentication method that is tied to specific auth method combinations used in an [authentication strength](authenticationstrengths-overview.md).
-This is an abstract type. In use, [fido2combinationConfigurations](fido2combinationconfiguration.md) may be created and managed as described below.
+Sets restrictions on specific types, modes, or versions of an authentication method that is tied to specific auth method combinations used in an [authentication strength](authenticationstrengths-overview.md).
+
+The following resources inherit from this abstract type and define the various types of combination configurations:
+* [fido2combinationConfigurations](fido2combinationconfiguration.md)
+* [x509certificatecombinationconfiguration](x509certificatecombinationconfiguration.md)
## Methods |Method|Return type|Description| |:|:|:| |[List](../api/authenticationstrengthpolicy-list-combinationconfigurations.md)|[authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) collection|Get a list of the [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) objects and their properties.|
-|[Create](../api/authenticationstrengthpolicy-post-combinationconfigurations.md)|[fido2combinationconfiguration](../resources/fido2combinationconfiguration.md)|Create a new [fido2combinationconfiguration](../resources/fido2combinationconfiguration.md) object.|
-|[Get](../api/authenticationcombinationconfiguration-get.md)|[fido2combinationconfiguration](../resources/fido2combinationconfiguration.md)|Read the properties and relationships of a [fido2combinationconfiguration](../resources/fido2combinationconfiguration.md) object.|
-|[Update](../api/authenticationcombinationconfiguration-update.md)|[fido2combinationconfiguration](../resources/fido2combinationconfiguration.md)|Update the properties of a [fido2combinationconfiguration](../resources/fido2combinationconfiguration.md) object.|
-|[Delete](../api/authenticationstrengthpolicy-delete-combinationconfigurations.md)|None|Deletes an [fido2combinationconfiguration](../resources/fido2combinationconfiguration.md) object.|
+|[Create](../api/authenticationstrengthpolicy-post-combinationconfigurations.md)|[authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md)| Create a new [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) |
+|[Get](../api/authenticationcombinationconfiguration-get.md)|[authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md)|Read the properties and relationships of a [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object.|
+|[Update](../api/authenticationcombinationconfiguration-update.md)|[authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md)|Update the properties of an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object.|
+|[Delete](../api/authenticationstrengthpolicy-delete-combinationconfigurations.md)|None|Delete an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object.|
## Properties |Property|Type|Description| |:|:|:|
-|appliesToCombinations|authenticationMethodModes collection|Which authentication method combinations this configuration applies to. Must be an **allowedCombinations** object that's defined for the [authenticationStrengthPolicy](../resources/authenticationstrengthpolicy.md). The only possible value for `fido2combinationConfigurations` is `"fido2"`.|
+|appliesToCombinations|authenticationMethodModes collection|Which authentication method combinations this configuration applies to. Must be an **allowedCombinations** object, part of the [authenticationStrengthPolicy](../resources/authenticationstrengthpolicy.md). The only possible value for `fido2combinationConfigurations` is `"fido2"`.|
|id|String|A unique system-generated identifier.| ## Relationships
-|id|String|A unique system-generated identifier.|
+None.
+ ## JSON representation The following JSON representation shows the resource type. <!-- {
The following JSON representation shows the resource type.
] } ```-
v1.0 Authenticationstrengthpolicy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/authenticationstrengthpolicy.md
A collection of settings that define specific combinations of authentication met
|[Update](../api/authenticationstrengthpolicy-update.md)|[authenticationStrengthPolicy](../resources/authenticationstrengthpolicy.md)|Update the properties of a custom [authenticationStrengthPolicy](../resources/authenticationstrengthpolicy.md) object. You can't update a built-in **authenticationStrengthPolicy** object. | |[Delete](../api/authenticationstrengthroot-delete-policies.md)|None|Delete a custom [authenticationStrengthPolicy](../resources/authenticationstrengthpolicy.md) object. You can't delete a built-in **authenticationStrengthPolicy** object.| |[List usage](../api/authenticationstrengthpolicy-usage.md)|[authenticationStrengthUsage](../resources/authenticationstrengthusage.md)|Find all [conditionalAccessPolicies](../resources/conditionalaccesspolicy.md) that reference an authentication strength.|
-|[updateAllowedCombinations](../api/authenticationstrengthpolicy-updateallowedcombinations.md)|[updateAllowedCombinationsResult](../resources/updateallowedcombinationsresult.md)|Update the allowed [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) for a given [authenticationStrengthPolicy](../resources/authenticationstrengthpolicy.md).|
+|[Update allowed combinations](../api/authenticationstrengthpolicy-updateallowedcombinations.md)|[updateAllowedCombinationsResult](../resources/updateallowedcombinationsresult.md)|Update the allowed [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) for a given [authenticationStrengthPolicy](../resources/authenticationstrengthpolicy.md).|
## Properties |Property|Type|Description|
v1.0 Call https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/call.md
https://teams.microsoft.com/l/meetup-join/19:meeting_NTg0NmQ3NTctZDVkZC00YzRhLTh
| [Invite participants](../api/participant-invite.md) | [commsOperation](commsoperation.md) | Invite participants to the active call. | | [Mute participant](../api/participant-mute.md) | [muteParticipantOperation](muteparticipantoperation.md) | Mute a participant in the group call. | | [Create](../api/call-post-audioroutinggroups.md) | [audioRoutingGroup](audioroutinggroup.md) | Create a new **audioRoutingGroup** by posting to the audioRoutingGroups collection. |
-| [List audioRoutingGroups](../api/call-list-audioroutinggroups.md) | [audioRoutingGroup](audioroutinggroup.md) collection | Get an **audioRoutingGroup** object collection. |
+| [List audio routing groups](../api/call-list-audioroutinggroups.md) | [audioRoutingGroup](audioroutinggroup.md) collection | Get an **audioRoutingGroup** object collection. |
| [Add large gallery view](../api/call-addlargegalleryview.md) | [addLargeGalleryViewOperation](addlargegalleryviewoperation.md) | Add the large gallery view to a call. | |**Interactive-voice-response** | | | | [Play prompt](../api/call-playprompt.md) | [playPromptOperation](playpromptoperation.md) | Play prompt in the call. |
v1.0 Channel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/channel.md
Title: "channel resource type"
-description: "A channel is a collection of chatMessages within a team. "
+description: "A channel is a collection of chatMessages within a team."
ms.localizationpriority: high
where files are shared, and where tabs are added.
|[List channel members](../api/channel-list-members.md) | [conversationMember](conversationmember.md) collection | Get the list of members in a channel.| |[Add channel member](../api/channel-post-members.md) | [conversationMember](conversationmember.md) | Add a member to a channel. Only supported for channels with a **membershipType** of `private` or `shared`.| |[Get channel member](../api/channel-get-members.md) | [conversationMember](conversationmember.md) collection | Get a member in a channel.|
+|[Archive channel](../api/channel-archive.md) | None | Archive a channel in a team.|
+|[Unarchive channel](../api/channel-unarchive.md) | None | Restore an archived channel in a team.|
|[Update channel member's role](../api/channel-update-members.md) | [conversationMember](conversationmember.md) | Update the properties of a member of the channel. Only supported for channels with a **membershipType** of `private` or `shared`.| |[Remove channel member](../api/channel-delete-members.md) | None | Delete a member from a channel. Only supported for channels with a **membershipType** of `private` or `shared`.| |[Complete migration](../api/channel-completemigration.md)|[channel](channel.md)| Removes the migration mode from the channel and makes the channel available to users to post and read messages.|
where files are shared, and where tabs are added.
|displayName|String|Channel name as it will appear to the user in Microsoft Teams. The maximum length is 50 characters.| |email|String| The email address for sending messages to the channel. Read-only.| |id|String|The channel's unique identifier. Read-only.|
+|isArchived| Boolean | Indicates whether the channel is archived. Read-only. |
|isFavoriteByDefault|Boolean|Indicates whether the channel should be marked as recommended for all members of the team to show in their channel list. **Note:** All recommended channels automatically show in the channels list for education and frontline worker users. The property can only be set programmatically via the [Create team](../api/team-post.md) method. The default value is `false`.| |membershipType|[channelMembershipType](../resources/channel.md#channelmembershiptype-values)|The type of the channel. Can be set during creation and can't be changed. The possible values are: `standard`, `private`, `unknownFutureValue`, `shared`. The default value is `standard`. Note that 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): `shared`.| |tenantId |string | The ID of the Microsoft Entra tenant. |
The following is a JSON representation of the resource.
```json {
- "createdDateTime": "string (timestamp)",
- "description": "string",
- "displayName": "string",
- "email": "string",
- "id": "string (identifier)",
- "isFavoriteByDefault": true,
+ "createdDateTime": "String (timestamp)",
+ "description": "String",
+ "displayName": "String",
+ "email": "String",
+ "id": "String (identifier)",
+ "isArchived": "Boolean",
+ "isFavoriteByDefault": "Boolean",
"membershipType": "String",
- "webUrl": "string"
+ "webUrl": "String"
} ```
v1.0 Conditionalaccessconditionset https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/conditionalaccessconditionset.md
Represents the type of conditions that govern when the policy applies.
|signInRiskLevels|riskLevel collection| Sign-in risk levels included in the policy. Possible values are: `low`, `medium`, `high`, `hidden`, `none`, `unknownFutureValue`. Required.| |userRiskLevels|riskLevel collection| User risk levels included in the policy. Possible values are: `low`, `medium`, `high`, `hidden`, `none`, `unknownFutureValue`. Required.| |users|[conditionalAccessUsers](conditionalaccessusers.md)| Users, groups, and roles included in and excluded from the policy. Either **users** or **clientApplications** is required. |
+|insiderRiskLevels|conditionalAccessInsiderRiskLevels| Insider risk levels included in the policy. The possible values are: `minor`, `moderate`, `elevated`, `unknownFutureValue`.|
## Relationships
The following is a JSON representation of the resource.
"servicePrincipalRiskLevels": ["String"], "signInRiskLevels": ["String"], "userRiskLevels": ["String"],
- "users": {"@odata.type": "microsoft.graph.conditionalAccessUsers"}
+ "users": {"@odata.type": "microsoft.graph.conditionalAccessUsers"},
+ "insiderRiskLevels": "String"
} ```
v1.0 Contact https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/contact.md
by providing a [delta](../api/contact-delta.md) function.
|**Open extensions**| | | |[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties in a new or existing instance of a resource.| |[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension object or objects identified by name or fully qualified name.|
-|**Schema extensions**| | |
-|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
|**Extended properties**| | | |[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[contact](contact.md) |Create one or more single-value extended properties in a new or existing contact. | |[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md) | [contact](contact.md) | Get contacts that contain a single-value extended property by using `$expand` or `$filter`. |
v1.0 Conversation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/conversation.md
This resource supports subscribing to [change notifications](/graph/webhooks).
| Method | Return Type |Description| |:|:--|:-|
-|[List conversations](../api/group-list-conversations.md) | [conversation](conversation.md) collection |Get the list of conversations in this group.|
-|[Create conversation](../api/group-post-conversations.md) |[conversation](conversation.md)| Create a new conversation by including a thread and a post.|
-|[Get conversation](../api/conversation-get.md) | [conversation](conversation.md) |Read properties and relationships of conversation object.|
+|[List](../api/group-list-conversations.md) | [conversation](conversation.md) collection |Get the list of conversations in this group.|
+|[Create](../api/group-post-conversations.md) |[conversation](conversation.md)| Create a new conversation by including a thread and a post.|
+|[Get](../api/conversation-get.md) | [conversation](conversation.md) |Read properties and relationships of conversation object.|
|[Delete](../api/conversation-delete.md) | None |Delete conversation object. | |[List conversation threads](../api/conversation-list-threads.md) |[conversationThread](conversationthread.md) collection| Get all the threads in a group conversation.| |[Create conversation thread](../api/conversation-post-threads.md) |[conversationThread](conversationthread.md) collection| Create a thread in the specified conversation.|
v1.0 Conversationthread https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/conversationthread.md
A new thread is created when a recipient is removed from the thread.
| Method | Return Type |Description| |:|:--|:-|
-|[List threads](../api/group-list-threads.md) | [conversationThread](conversationthread.md) collection |Get all the threads of a group.|
-|[Create thread](../api/group-post-threads.md) | [conversationThread](conversationthread.md) |Start a new conversation by first creating a thread. A new conversation, conversation thread, and post are created in the group.|
-|[Get conversationThread](../api/conversationthread-get.md) | [conversationThread](conversationthread.md) |Get a specific thread that belongs to a group. |
+|[List](../api/group-list-threads.md) | [conversationThread](conversationthread.md) collection |Get all the threads of a group.|
+|[Create](../api/group-post-threads.md) | [conversationThread](conversationthread.md) |Start a new conversation by first creating a thread. A new conversation, conversation thread, and post are created in the group.|
+|[Get](../api/conversationthread-get.md) | [conversationThread](conversationthread.md) |Get a specific thread that belongs to a group. |
|[Update](../api/conversationthread-update.md) | [conversationThread](conversationthread.md) |Update conversationThread object. | |[Delete](../api/conversationthread-delete.md) | None |Delete conversationThread object. | |[Reply to conversation thread](../api/conversationthread-reply.md)|None|Reply to this thread by creating a new Post entity.|
v1.0 Crosstenantaccesspolicy Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/crosstenantaccesspolicy-overview.md
Namespace: microsoft.graph
In the traditional Microsoft Entra B2B collaboration, any invited user from an organization could use their identity to access resources in external organizations. Administrators didn't have control over the user identities in their tenant that are allowed to sign in to external organizations. These limited controls made it difficult to prevent identities from your organization from being used in unauthorized ways.
-**Cross-tenant access settings** let you control and manage collaboration between users in your organization and other organizations. The control can be on either **outbound access** (how your users collaborate with other organizations), **inbound access** (how other organizations collaborate with you), or both.
+**Cross-tenant access settings** let you control and manage collaboration between users in your organization and other organizations. The control can be on one or a combination of the following configurations:
++ **outbound access** - how your users collaborate with other organizations.++ **inbound access** - how other organizations collaborate with you.++ **tenant restrictions access** - how your users collaborate with other organizations using other organization identities from your network or devices.
-Granular controls let you determine the users, groups, and apps, both in your organization and in external organizations that can participate in z B2B collaboration and Microsoft Entra B2B direct connect. These controls are implemented through:
+Granular controls let you determine the users, groups, and apps, both in your organization and in external organizations, that can participate in cross-tenant collaboration. These controls are implemented through:
-+ **Default cross-tenant access settings** which set the baseline inbound and outbound access settings.
- + In Microsoft Entra B2B collaboration, both 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.
- + In Microsoft Entra B2B direct connect, both access settings are disabled by default.
- + The service default settings can be updated.
-+ **Partner-specific access settings** which allow you to configure customized settings for individual organizations. For the configured organizations, this configuration takes precedence over the default settings. Therefore, while Microsoft Entra B2B collaboration and Microsoft Entra B2B direct connect might be disabled across your organization by default, you can enable these features for a specific external organization.
++ **Default cross-tenant access settings** which set the baseline settings for inbound and outbound access and tenant restrictions.
+ + 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.
+ + In Microsoft Entra B2B direct connect, both inbound and outbound access settings are disabled by default.
+ + The service default settings may be updated.
+ + In Tenant Restrictions, all access settings are disabled by default.
+++ **Partner-specific access settings** which allow you to configure customized settings for individual organizations. For the configured organizations, this configuration takes precedence over the default settings. Therefore, while Microsoft Entra B2B collaboration, Microsoft Entra B2B direct connect, and tenant restrictions might be disabled across your organization, you can enable these features for a specific external organization. > [!IMPORTANT] >
Granular controls let you determine the users, groups, and apps, both in your or
## Default cross-tenant access settings
-Default cross-tenant access settings determine your stance for inbound and outbound collaboration with all other Microsoft Entra organizations. Any external collaboration with an organization not listed explicitly in your cross-tenant access settings inherit these default settings. Default settings are defined using the [crossTenantAccessPolicyConfigurationDefault](../resources/crosstenantaccesspolicyconfigurationdefault.md) resource type.
+Default cross-tenant access settings determine your stance for inbound and outbound collaboration and tenant restrictions with all other Microsoft Entra organizations. Any external collaboration with an organization not listed explicitly in your cross-tenant access settings inherits these default settings. Default settings are defined using the [crossTenantAccessPolicyConfigurationDefault](../resources/crosstenantaccesspolicyconfigurationdefault.md) resource type.
By default, Microsoft Entra ID assigns all Microsoft Entra tenants a service default configuration for cross-tenant access settings. You can override these service defaults with your own configuration to suit your organization. You can confirm whether you're using the service default settings or custom settings by looking at the **isServiceDefault** property returned when you query the default endpoint. ## Partner cross-tenant access settings
-Partner-specific cross-tenant access settings determine your stance for inbound and outbound collaboration with a specific Microsoft Entra organization. Any collaboration with this organization inherits these partner-specific settings. Partner settings are defined using the [crossTenantAccessPolicyConfigurationPartner](../resources/crosstenantaccesspolicyconfigurationpartner.md) resource type.
+Partner-specific cross-tenant access settings determine your stance for inbound and outbound collaboration and tenant restrictions with a specific Microsoft Entra organization. Any collaboration with this organization inherits these partner-specific settings. Partner settings are defined using the [crossTenantAccessPolicyConfigurationPartner](../resources/crosstenantaccesspolicyconfigurationpartner.md) resource type.
Unless you configure all the properties of the partner-specific object, some of your default settings might still apply. For example, if you configure only **b2bCollaborationInbound** for a partner in your cross-tenant access settings, the partner configuration inherits the other settings from the default cross-tenant access settings. When querying the partner endpoint, any property on the partner object that is `null` inherits settings from the default policy.
Learn more about [collaborating with organizations from a different Microsoft cl
## Interpreting the API response
-The cross-tenant access settings API can be used to set up multiple configurations for allowing or blocking access to and from your organization. The following table highlights scenarios, shows an example of the API response, and what the interpretation should be of that response. **b2bSetting** is used as a placeholder for any B2B inbound (**b2bCollaborationInbound** or **b2bDirectConnectInbound**) or outbound (**b2bCollaborationOutbound** or **b2bDirectConnectOutbound**) configuration.
+The cross-tenant access settings API can be used to set up multiple configurations for allowing or blocking access to and from your organization. The following table highlights scenarios, shows an example of the API response, and what the interpretation should be of that response. **b2bSetting** is used as a placeholder for any B2B inbound (**b2bCollaborationInbound** or **b2bDirectConnectInbound**) or outbound (**b2bCollaborationOutbound** or **b2bDirectConnectOutbound**) or tenant restrictions (**tenantRestrictions**) configuration.
<br/>
Check if the guest user is from an externally federated partner before trying En
## Cross-tenant access settings vs tenant restrictions
-Cross-tenant access settings outbound controls are for controlling how **your organization's accounts** are used for accessing resources in other Microsoft Entra organizations. Tenant Restrictions are for controlling how your employees use **other Microsoft Entra organizations' accounts while the employee is on your networks or devices**. Critically, outbound controls work all the time because they're associated with your accounts, while Tenant Restrictions require additional signals to be injected into the authentication requests to be enforced, because Tenant Restrictions are scoped to networks and devices, not accounts. Learn more about [Tenant Restrictions](/azure/active-directory/manage-apps/tenant-restrictions).
+Cross-tenant access settings outbound controls are for controlling how **your organization's accounts** are used for accessing resources in other Microsoft Entra organizations. Tenant Restrictions are for controlling how your employees use **other Microsoft Entra organizations' accounts while the employee is on your networks or devices**. Critically, outbound controls work all the time because they're associated with your accounts, while Tenant Restrictions require other signals to be injected into the authentication requests to be enforced, because tenant restrictions are scoped to networks and devices, not accounts. Learn more about [tenant restrictions](/azure/active-directory/manage-apps/tenant-restrictions).
## Related content
v1.0 Crosstenantaccesspolicyconfigurationdefault https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/crosstenantaccesspolicyconfigurationdefault.md
Title: "crossTenantAccessPolicyConfigurationDefault resource type"
-description: "The default configuration defined for inbound and outbound settings of Microsoft Entra B2B collaboration and B2B direct connect."
+description: "Represents the default configuration for cross-tenant access and tenant restrictions."
ms.localizationpriority: medium
doc_type: resourcePageType
Namespace: microsoft.graph
-The default configuration defined for inbound and outbound settings of Microsoft Entra B2B collaboration and B2B direct connect.
+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.
## Methods
The default configuration defined for inbound and outbound settings of Microsoft
| inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the default configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. | | invitationRedemptionIdentityProviderConfiguration | [defaultInvitationRedemptionIdentityProviderConfiguration](../resources/defaultInvitationRedemptionIdentityProviderConfiguration.md) | Defines the priority order based on which an identity provider is selected during invitation redemption for a guest user. | | isServiceDefault | Boolean | If `true`, the default configuration is set to the system default configuration. If `false`, the default settings are customized. |
+| 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. |
## Relationships
The following JSON representation shows the resource type.
"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"
+ "invitationRedemptionIdentityProviderConfiguration": {"@odata.type": "microsoft.graph.defaultInvitationRedemptionIdentityProviderConfiguration"},
+ "isServiceDefault": "Boolean",
+ "tenantRestrictions": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyTenantRestrictions"}
} ```
v1.0 Crosstenantaccesspolicyconfigurationpartner https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/crosstenantaccesspolicyconfigurationpartner.md
Title: "crossTenantAccessPolicyConfigurationPartner resource type"
-description: "The partner-specific configuration that is defined for inbound and outbound settings of Microsoft Entra B2B collaboration and B2B direct connect."
+description: "Represents the partner-specific configuration for cross-tenant access and tenant restrictions."
ms.localizationpriority: medium
doc_type: resourcePageType
Namespace: microsoft.graph
-The partner-specific configuration that is defined for inbound and outbound settings of Microsoft Entra B2B and B2B direct connect collaboration.
+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).
+For any partner-specific property that is `null`, these settings inherit the behavior configured in your [default cross-tenant access settings](../resources/crosstenantaccesspolicyconfigurationdefault.md).
## Methods
For any partner-specific property that is `null`, these settings inherit the beh
| isInMultiTenantOrganization | Boolean | Identifies whether a tenant is a member of a multitenant organization. | | isServiceProvider | Boolean | Identifies whether the partner-specific configuration is a Cloud Service Provider for your organization. | | tenantId | String | The tenant identifier for the partner Microsoft Entra organization. Read-only. Key.|
+| 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. |
## Relationships
The following JSON representation shows the resource type.
"inboundTrust": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyInboundTrust"}, "isInMultiTenantOrganization": "Boolean", "isServiceProvider": "Boolean",
- "tenantId": "String (identifier)"
+ "tenantId": "String (identifier)",
+ "tenantRestrictions": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyTenantRestrictions"}
} ```
v1.0 Crosstenantaccesspolicytarget https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/crosstenantaccesspolicytarget.md
Defines how to target your cross-tenant access policy settings. Settings can be
|Property|Type|Description| |:|:|:|
-| target | String | The unique identifier of the user, group, or application; one of the following keywords: `AllUsers` and `AllApplications`; or for targets that are applications, you may use [reserved values](#reserved-values-for-targets-that-are-applications). |
+| 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. |
| targetType | crossTenantAccessPolicyTargetType | The type of resource that you want to target. The possible values are: `user`, `group`, `application`, `unknownFutureValue`. | ### Reserved values for targets that are applications
v1.0 Crosstenantaccesspolicytenantrestrictions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/crosstenantaccesspolicytenantrestrictions.md
+
+ Title: "crossTenantAccessPolicyTenantRestrictions resource type"
+description: "Defines how to configure Microsoft Entra tenant restrictions settings that give you control over the external organizations that your users can access from your network or devices when they use external identities."
+
+ms.localizationpriority: medium
+++
+# crossTenantAccessPolicyTenantRestrictions resource type
+
+Namespace: microsoft.graph
+
+Defines how to target your tenant restrictions settings. Tenant restrictions give you control over the external organizations that your users can access from your network or devices when they use external identities. Settings can be targeted to specific users, groups, or applications.
+
+Inherits from [crossTenantAccessPolicyB2BSettings](../resources/crosstenantaccesspolicyb2bsetting.md).
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|applications|[crossTenantAccessPolicyTargetConfiguration](../resources/crosstenantaccesspolicytargetconfiguration.md)|The list of applications targeted with your cross-tenant access policy. Inherited from [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md).|
+|devices|[devicesFilter](../resources/devicesfilter.md)|Defines the rule for filtering devices and whether devices that satisfy the rule should be allowed or blocked. This property isn't supported on the server side yet. |
+|usersAndGroups|[crossTenantAccessPolicyTargetConfiguration](../resources/crosstenantaccesspolicytargetconfiguration.md)|The list of users and groups targeted with your cross-tenant access policy. Inherited from [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md).|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.crossTenantAccessPolicyTenantRestrictions"
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.crossTenantAccessPolicyTenantRestrictions",
+ "applications": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyTargetConfiguration"},
+ "devices": {"@odata.type": "microsoft.graph.devicesFilter"},
+ "usersAndGroups": {"@odata.type": "microsoft.graph.crossTenantAccessPolicyTargetConfiguration"}
+}
+```
+
+## Related content
+
+[Set up tenant restrictions V2 (Preview)](/azure/active-directory/external-identities/tenant-restrictions-v2)
+
v1.0 Devicesfilter https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/devicesfilter.md
+
+ Title: "devicesFilter resource type"
+description: "Defines a rule to filter the devices and whether devices that satisfy the rule should be allowed or blocked."
+
+ms.localizationpriority: medium
+++
+# devicesFilter resource type
+
+Namespace: microsoft.graph
+
+Defines a rule to filter the devices and whether devices that satisfy the rule should be allowed or blocked.
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|mode|crossTenantAccessPolicyTargetConfigurationAccessType|Determines whether devices that satisfy the rule should be allowed or blocked. The possible values are: `allowed`, `blocked`, `unknownFutureValue`.|
+|rule|String|Defines the rule to filter the devices. For example, `device.deviceAttribute2 -eq 'PrivilegedAccessWorkstation'`.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.devicesFilter"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.devicesFilter",
+ "mode": "String",
+ "rule": "String"
+}
+```
v1.0 Educationuser https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationuser.md
Inherits from [entity](../resources/entity.md).
| Method | Return type | Description | | : | :- | :- |
-| [List users](../api/educationuser-list.md) | [educationUser](../resources/educationuser.md) collection | Get a list of the [educationUser](../resources/educationuser.md) objects and their properties. |
-| [Create user](../api/educationuser-post.md) | [educationUser](../resources/educationuser.md) | Create a new [educationUser](../resources/educationuser.md) object. |
-| [Get user](../api/educationuser-get.md) | [educationUser](../resources/educationuser.md) | Read the properties and relationships of an [educationUser](../resources/educationuser.md) object. |
-| [Update educationUser](../api/educationuser-update.md) | [educationUser](../resources/educationuser.md) | Update the properties of an [educationUser](../resources/educationuser.md) object. |
-| [Delete user](../api/educationuser-delete.md) | None | Delete an [educationUser](../resources/educationuser.md) object. |
+| [List](../api/educationuser-list.md) | [educationUser](../resources/educationuser.md) collection | Get a list of the [educationUser](../resources/educationuser.md) objects and their properties. |
+| [Create](../api/educationuser-post.md) | [educationUser](../resources/educationuser.md) | Create a new [educationUser](../resources/educationuser.md) object. |
+| [Get](../api/educationuser-get.md) | [educationUser](../resources/educationuser.md) | Read the properties and relationships of an [educationUser](../resources/educationuser.md) object. |
+| [Update](../api/educationuser-update.md) | [educationUser](../resources/educationuser.md) | Update the properties of an [educationUser](../resources/educationuser.md) object. |
+| [Delete](../api/educationuser-delete.md) | None | Delete an [educationUser](../resources/educationuser.md) object. |
| [Get changes to users](../api/educationuser-delta.md) | [educationUser](../resources/educationuser.md) collection | Get incremental changes to the resource collection. | | [List taught classes](../api/educationuser-list-taughtclasses.md) | [educationClass](../resources/educationclass.md) collection | Get the **educationClass** resources from the **taughtClasses** navigation property. |
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/enums.md
Namespace: microsoft.graph
| :-- | | user | | group |
+|application|
+|unknownFutureValue|
### multiTenantOrganizationMemberProcessingStatus values
Possible values for user account types (group membership), per Windows definitio
|microsoftAccount| |defaultConfiguredIdp| |unknownFutureValue|+
+### conditionalAccessInsiderRiskLevels values
+
+|Member|
+|:|
+|minor|
+|moderate|
+|elevated|
+|unknownFutureValue|
v1.0 Event https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/event.md
This resource supports:
|**Open extensions**| | | |[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties to a new or existing resource.| |[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension identified by the extension name.|
-|**Schema extensions**| | |
-|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
|**Extended properties**| | | |[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[event](event.md) |Create one or more single-value extended properties in a new or existing event. | |[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md) | [event](event.md) | Get events that contain a single-value extended property by using `$expand` or `$filter`. |
v1.0 Fido2combinationconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/fido2combinationconfiguration.md
Title: "fido2CombinationConfiguration resource type"
-description: "Configuration to require specific FIDO2 key types in an authentication strength"
+description: "Configuration to require specific FIDO2 keys in an authentication strength"
ms.localizationpriority: medium
doc_type: resourcePageType
Namespace: microsoft.graph
-Configuration to require specific FIDO2 key types in an authentication strength. An administrator may use this entity to specify which Authenticator Attestation GUIDs (AAGUIDs) are allowed, as part of certain authentication method combinations, in an [authentication strength](authenticationstrengthpolicy.md).
-
+Configuration to require specific FIDO2 keys in an authentication strength. Use this entity to specify which Authenticator Attestation GUIDs (AAGUIDs) are allowed, as part of certain authentication method combinations, in an [authentication strength](authenticationstrengthpolicy.md).
Inherits and derived from [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md).
None.
|Property|Type|Description| |:|:|:| |allowedAAGUIDs|String collection|A list of AAGUIDs allowed to be used as part of the specified authentication method combinations.|
-|appliesToCombinations|authenticationMethodModes collection|Which authentication method combinations this configuration applies to. The only possible value for fido2combinationConfigurations is `"fido2"`. Inherited from [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md).|
+|appliesToCombinations|authenticationMethodModes collection|Which authentication method combinations this configuration applies to. The only possible value is `"fido2"`. Inherited from [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md).|
|id|String|A system-generated identifier. Inherited from [entity](../resources/entity.md).| ## Relationships
v1.0 Identityuserflowattributeassignment https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identityuserflowattributeassignment.md
Represents how attributes are collected in an identity user flow. and allows cus
|[Get](../api/identityuserflowattributeassignment-get.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md)|Read the properties and relationships of an identityUserFlowAttributeAssignment object.| |[Update](../api/identityuserflowattributeassignment-update.md)|None|Update the properties of an identityUserFlowAttributeAssignment object.| |[Delete](../api/identityuserflowattributeassignment-delete.md)|None|Delete a specific identityUserFlowAttributeAssignment object.|
-|[getOrder](../api/identityuserflowattributeassignment-getorder.md)|[assignmentOrder](../resources/assignmentorder.md)|Gets the order of the identityUserFlowAttributes being collected within a user flow.|
-|[setOrder](../api/identityuserflowattributeassignment-setorder.md)|None|Sets the order of the identityUserFlowAttributes being collected within a user flow.|
+|[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.|
## Properties
v1.0 Message https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/message.md
by providing a [delta](../api/message-delta.md) function.
|**Open extensions**| | | |[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties in a new or existing instance of a resource.| |[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension object or objects identified by name or fully qualified name.|
-|**Schema extensions**| | |
-|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
|**Extended properties**| | | |[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[message](message.md) |Create one or more single-value extended properties in a new or existing message. | |[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md) | [message](message.md) | Get messages that contain a single-value extended property by using `$expand` or `$filter`. |
v1.0 Notebook https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/notebook.md
The following JSON representation shows the resource type.
|:|:--|:-| |[Get notebook](../api/notebook-get.md) | [Notebook](notebook.md) |Read the properties and relationships of the notebook.| |[Get recent notebooks](../api/notebook-getrecentnotebooks.md) | [recentNotebook](recentnotebook.md) collection | Get a collection of the most recently accessed notebooks for the user. |
-|[getNotebookFromWebUrl](../api/notebook-getnotebookfromweburl.md) | [Notebook](notebook.md) | Retrieve the properties and relationships of a notebook object using its URL path. |
+|[Get notebook from web](../api/notebook-getnotebookfromweburl.md) | [Notebook](notebook.md) | Retrieve the properties and relationships of a notebook object using its URL path. |
|[Create section group](../api/notebook-post-sectiongroups.md) |[SectionGroup](sectiongroup.md)| Create a section group by posting to the sectionGroups collection in the specified notebook.| |[List section groups](../api/notebook-list-sectiongroups.md) |[SectionGroup](sectiongroup.md) collection| Get a collection of section groups in the specified notebook.| |[Create section](../api/notebook-post-sections.md) |[OnenoteSection](section.md)| Create a section by posting to the sections collection in the specified notebook.|
v1.0 Onlinemeeting https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onlinemeeting.md
Contains information about a meeting, including the URL used to join a meeting,
| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | allowParticipantsToChangeName | Boolean | Specifies if participants are allowed to rename themselves in an instance of the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| attendeeReport (deprecated) | Stream | The content stream of the attendee report of a [Microsoft Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. |
| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| broadcastSettings (deprecated) | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event. |
| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | creationDateTime | DateTime | The meeting creation time in UTC. Read-only. |
-| endDateTime | DateTime | The meeting end time in UTC. Required when you create an online meeting. |
-| id | String | The default ID associated with the online meeting. Read-only. |
-| isBroadcast (deprecated) | Boolean | Indicates whether this meeting is a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). |
-| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. |
-| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in the `Accept-Language` request HTTP header. Read-only. |
-| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. |
+| endDateTime | DateTime | The meeting end time in UTC. Required when you create an online meeting.
| joinWebUrl | String | The join URL of the online meeting. The format of the URL may change; therefore, users shouldn't rely on any information extracted from parsing the URL. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
-| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. |
| participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting, including the organizer and the attendees. |
-| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. |
-| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. |
-| startDateTime | DateTime | The meeting start time in UTC. Required when you create an online meeting. |
| subject | String | The subject of the online meeting. Required when you create an online meeting. |
-| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. |
-| endDateTime | DateTime | The meeting end time in UTC. |
| id | String | The default ID associated with the online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| isBroadcast (deprecated) | Boolean | Indicates whether this event is a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). |
| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in the `Accept-Language` request HTTP header. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| joinWebUrl | String | The join URL of the online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting, including the organizer and the attendees. |
+| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | startDateTime | DateTime | The meeting start time in UTC. |
-| subject | String | The subject of the online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark a content type. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
+| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark a content type. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| attendeeReport (deprecated) | Stream | The content stream of the attendee report of a [Microsoft 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 meeting is a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). |
### onlineMeetingPresenters values
v1.0 Orgcontact https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/orgcontact.md
This resource supports using [delta query](/graph/delta-query-overview) to track
| **Organizational hierarchy** | | [Get manager](../api/orgcontact-get-manager.md) | [directoryObject](directoryobject.md) | Get the organizational contact's manager. | | [List direct reports](../api/orgcontact-list-directreports.md) | [directoryObject](directoryobject.md) collection | List the organizational contact's direct reports. |
-| [List memberOf](../api/orgcontact-list-memberof.md) | [directoryObject](directoryobject.md) collection | List the groups an organizational contact is a member of. |
-| [List transitiveMemberOf](../api/orgcontact-list-transitivememberof.md) | [directoryObject](directoryobject.md) collection | List the groups an organizational contact is a member of, including groups that the organizational contact is nested under. |
+| [List memberships](../api/orgcontact-list-memberof.md) | [directoryObject](directoryobject.md) collection | List the groups an organizational contact is a member of. |
+| [List transitive memberships](../api/orgcontact-list-transitivememberof.md) | [directoryObject](directoryobject.md) collection | List the groups an organizational contact is a member of, including groups that the organizational contact is nested under. |
| [Check member groups](../api/directoryobject-checkmembergroups.md) | String collection | Check for group membership. | | [Get member groups](../api/directoryobject-getmembergroups.md) | String collection | Return all the groups that the specified organizational contact is a member of. | | [Get member objects](../api/directoryobject-getmemberobjects.md) | String collection | Returns a list of directoryObjects the organizational contact is a member of. |
v1.0 Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/post.md
This resource lets you add your own data to custom properties using [extensions]
|**Open extensions**| | | |[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties in a new or existing instance of a resource.| |[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension object or objects identified by name or fully qualified name.|
-|**Schema extensions**| | |
-|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
|**Extended properties**| | | |[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[post](post.md) |Create one or more single-value extended properties in a new or existing post. | |[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md) | [post](post.md) | Get posts that contain a single-value extended property by using `$expand` or `$filter`. |
v1.0 Security Alert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-alert.md
When a security provider detects a threat, it creates an alert in the system. Mi
## Methods |Method|Return type|Description| |:|:|:|
-|[List alerts_v2](../api/security-list-alerts_v2.md)|[microsoft.graph.security.alert](security-alert.md) collection|Get a list of [alert](../resources/security-alert.md) resources created to track suspicious activities in an organization.|
-|[Get alert](../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 alert](../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 for alert](../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.|
+|[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 created to 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.|
## Properties |Property|Type|Description|
v1.0 Shared https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/shared.md
Title: shared resource type ms.localizationpriority: medium
-description: "The shared resource indicates a driveItem has been shared with others."
+description: "Indicates that a drive item has been shared with others."
doc_type: resourcePageType
doc_type: resourcePageType
Namespace: microsoft.graph
-The **shared** resource indicates a **driveItem** has been shared with others.
-The resource includes information about how the item is shared.
+Indicates that a [drive item](driveitem.md) was shared with others and includes information about how the item was shared.
-If a [**driveitem**](driveitem.md) has a non-null **shared** facet, the item has been 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. |
## JSON representation
If a [**driveitem**](driveitem.md) has a non-null **shared** facet, the item has
} ```
-## Properties
-
-| Property | Type | Description
-| :- |:|:-
-| owner | [IdentitySet](identityset.md) | The identity of the owner of the shared item. Read-only.
-| scope | String | Indicates the scope of how the item is shared: `anonymous`, `organization`, or `users`. 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 options
-
-| 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. |
-
-## Remarks
-
-For more information about the facets on a **driveItem**, see [**driveItem**](driveitem.md).
<!-- { "type": "#page.annotation",
v1.0 Teamsapp https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamsapp.md
Users can see these apps in the Microsoft Teams Store, and these apps can be ins
|[Publish apps to catalog](../api/teamsapp-publish.md) | [teamsApp](teamsapp.md) | Upload an app to your organization's app catalog.| |[Update app in catalog](../api/teamsapp-update.md) | [teamsApp](teamsapp.md) | Update an app in your organization's app catalog.| |[Delete app from catalog](../api/teamsapp-delete.md) | None | Remove an app from your organization's app catalog.|
-|[Get bot associated with app in catalog](../api/teamworkbot-get.md) | [teamworkbot](teamworkbot.md) | Get the bot associated with the Teams app.|
+|[Get associated bot](../api/teamworkbot-get.md) | [teamworkbot](teamworkbot.md) | Get the bot associated with the Teams app.|
## Properties
v1.0 Teamsasyncoperation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamsasyncoperation.md
When the request completes successfully, the status will be "succeeded" and the
|attemptsCount|Int32|Number of times the operation was attempted before being marked successful or failed.| |createdDateTime|DateTimeOffset |Time when the operation was created.| |error|[operationError](operationerror.md)|Any error that causes the async operation to fail.|
-|id|string |Unique operation id.|
+|id|string |Unique operation ID.|
|lastActionDateTime|DateTimeOffset |Time when the async operation was last updated.|
-|operationType|[teamsAsyncOperationType](teamsasyncoperationtype.md) |Denotes which type of operation is being described.|
+|operationType|[teamsAsyncOperationType](teamsasyncoperationtype.md) |Denotes the type of operation described. Possible values are: `invalid`, `cloneTeam`, `archiveTeam`, `unarchiveTeam`, `createTeam`, `unknownFutureValue`, `teamifyGroup`, `createChannel`, `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`, `archiveChannel`, `unarchiveChannel`. |
|status|[teamsAsyncOperationStatus](teamsasyncoperationstatus.md)| Operation status.|
-|targetResourceId|guid |The ID of the object that's created or modified as result of this async operation, typically a [team](../resources/team.md).|
+|targetResourceId|String |The ID of the object that's created or modified as result of this async operation, typically a [team](../resources/team.md).|
|targetResourceLocation|string|The location of the object that's created or modified as result of this async operation. This URL should be treated as an opaque value and not parsed into its component paths.| ## JSON representation
-The following is a JSON representation of the resource.
+The following JSON representation shows the resource type.
<!-- { "blockType": "resource",
The following is a JSON representation of the resource.
```json {
- "id": "string",
- "operationType": "archiveTeam",
- "createdDateTime": "2018-01-01T00:00:00.0000000Z",
- "status": "succeeded",
- "lastActionDateTime": "2018-01-01T00:00:00.0000000Z",
- "attemptsCount": 1,
- "targetResourceId": "fa4aa5a2-a75b-4769-86f4-9e2742a18fda",
- "targetResourceLocation": "/groups('fa4aa5a2-a75b-4769-86f4-9e2742a18fda')/team",
- "error": null
+ "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"
} ```
v1.0 Teamsasyncoperationtype https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamsasyncoperationtype.md
Title: "teamsAsyncOperationType enum type"
-description: "Types of teamsAsyncOperation. Members are added here as more async operations are supported."
+description: "Types of teamsAsyncOperation."
ms.localizationpriority: medium
Namespace: microsoft.graph
-Types of [teamsAsyncOperation](teamsasyncoperation.md). Members are added here as more async operations are supported.
+Types of [teamsAsyncOperation](teamsasyncoperation.md). Members are added as more async operations are supported. 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`, `archiveChannel`, `unarchiveChannel`.
## Members
Types of [teamsAsyncOperation](teamsasyncoperation.md). Members are added here a
|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. | |teamifyGroup |Operation to create a team from a group. | |createChannel |Operation to create a channel in a team. |
+|archiveChannel |Operation to archive a channel.|
+|unarchiveChannel |Operation to unarchive a channel.|
v1.0 X509certificatecombinationconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/x509certificatecombinationconfiguration.md
+
+ Title: "x509CertificateCombinationConfiguration resource type"
+description: "Configuration to require a specific certificate in an authentication strength policy."
++
+ms.localizationpriority: medium
++++
+# x509CertificateCombinationConfiguration resource type
+
+Namespace: microsoft.graph
+
+Configuration to require specific certificate properties. You can use this entity to specify the certificate issuer or policy OID that are allowed, as part of certificate-based authentication, in an [authentication strength policy](authenticationstrengthpolicy.md).
+
+Inherits from [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md).
+
+## Methods
+None.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|allowedIssuerSkis|String collection|A list of allowed subject key identifier values.|
+|allowedPolicyOIDs|String collection|A list of allowed policy OIDs.|
+|appliesToCombinations|authenticationMethodModes collection| Which authentication method combinations this configuration applies to. The possible values for x509certificatecombinationconfiguration are `"x509CertificateSingleFactor"` or `"x509CertificateMultiFactor"`. Inherited from [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md).|
+|id|String|A system-generated identifier. Inherited from [entity](../resources/entity.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.x509CertificateCombinationConfiguration",
+ "baseType": "microsoft.graph.authenticationCombinationConfiguration",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.x509CertificateCombinationConfiguration",
+ "id": "String (identifier)",
+ "appliesToCombinations": [
+ "String"
+ ],
+ "allowedIssuerSkis": [
+ "String"
+ ],
+ "allowedPolicyOIDs": [
+ "String"
+ ]
+}
+```
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/calendars/toc.yml a/api-reference/v1.0/toc/calendars/toc.yml
items:
href: ../../api/opentypeextension-post-opentypeextension.md - name: Get open extension href: ../../api/opentypeextension-get.md
- - name: Schema extensions
- items:
- - name: Add schema extension values
- href: /graph/extensibility-schema-groups
- name: Extended properties items: - name: Create single-value property
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/education/toc.yml a/api-reference/v1.0/toc/education/toc.yml
items:
items: - name: User href: ../../resources/educationuser.md
- - name: List users
+ - name: List
href: ../../api/educationuser-list.md
- - name: Create user
+ - name: Create
href: ../../api/educationuser-post.md
- - name: Get user
+ - name: Get
href: ../../api/educationuser-get.md
- - name: Update educationUser
+ - name: Update
href: ../../api/educationuser-update.md
- - name: Delete user
+ - name: Delete
href: ../../api/educationuser-delete.md - name: Get changes to users href: ../../api/educationuser-delta.md
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/identity-and-access/toc.yml a/api-reference/v1.0/toc/identity-and-access/toc.yml
items:
href: ../../api/orgcontact-get-manager.md - name: List direct reports href: ../../api/orgcontact-list-directreports.md
- - name: List memberOf
+ - name: List memberships
href: ../../api/orgcontact-list-memberof.md
- - name: List transitiveMemberOf
+ - name: List transitive memberships
href: ../../api/orgcontact-list-transitivememberof.md - name: Check member groups href: ../../api/directoryobject-checkmembergroups.md
items:
href: ../../resources/accessreviewhistoryinstance.md - name: List href: ../../api/accessreviewhistorydefinition-list-instances.md
- - name: generateDownloadUri
+ - name: Generate download URI
href: ../../api/accessreviewhistoryinstance-generatedownloaduri.md - name: Access review instance items:
items:
href: ../../api/authenticationstrengthroot-delete-policies.md - name: List usage href: ../../api/authenticationstrengthpolicy-usage.md
- - name: updateAllowedCombinations
+ - name: Update allowed combinations
href: ../../api/authenticationstrengthpolicy-updateallowedcombinations.md - name: Authentication combination configuration items:
items:
href: ../../api/authenticationcombinationconfiguration-update.md - name: Delete href: ../../api/authenticationstrengthpolicy-delete-combinationconfigurations.md
+ - name: FIDO2 combination configuration
+ href: ../../resources/fido2combinationconfiguration.md
+ - name: X509 certificate combination configuration
+ href: ../../resources/x509certificatecombinationconfiguration.md
- name: Authentication method mode detail items: - name: Authentication method mode detail
items:
href: ../../api/authenticationstrengthroot-delete-policies.md - name: List usage href: ../../api/authenticationstrengthpolicy-usage.md
- - name: updateAllowedCombinations
+ - name: Update allowed combinations
href: ../../api/authenticationstrengthpolicy-updateallowedcombinations.md - name: Feature rollout policy items:
items:
href: ../../api/identityuserflowattributeassignment-update.md - name: Delete href: ../../api/identityuserflowattributeassignment-delete.md
- - name: getOrder
+ - name: Get order
href: ../../api/identityuserflowattributeassignment-getorder.md
- - name: setOrder
+ - name: Set order
href: ../../api/identityuserflowattributeassignment-setorder.md - name: User flow language configuration items:
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/mail/toc.yml a/api-reference/v1.0/toc/mail/toc.yml
items:
href: ../../api/opentypeextension-post-opentypeextension.md - name: Get open extension href: ../../api/opentypeextension-get.md
- - name: Schema extensions
- items:
- - name: Add schema extension values
- href: /graph/extensibility-schema-groups
- name: Extended properties items: - name: Create single-value property
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/notes/toc.yml a/api-reference/v1.0/toc/notes/toc.yml
items:
href: ../../api/notebook-get.md - name: Get recent notebooks href: ../../api/notebook-getrecentnotebooks.md
- - name: getNotebookFromWebUrl
+ - name: Get notebook from web
href: ../../api/notebook-getnotebookfromweburl.md - name: Create section group href: ../../api/notebook-post-sectiongroups.md
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/personal-contacts/toc.yml a/api-reference/v1.0/toc/personal-contacts/toc.yml
items:
href: ../../api/opentypeextension-post-opentypeextension.md - name: Get open extension href: ../../api/opentypeextension-get.md
- - name: Schema extensions
- items:
- - name: Add schema extension values
- href: /graph/extensibility-schema-groups
- name: Extended properties items: - name: Create single-value property
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/security/toc.yml a/api-reference/v1.0/toc/security/toc.yml
items:
items: - name: Alert href: ../../resources/security-alert.md
- - name: List alerts_v2
+ - name: List
href: ../../api/security-list-alerts_v2.md
- - name: Get alert
+ - name: Get
href: ../../api/security-alert-get.md
- - name: Update alert
+ - name: Update
href: ../../api/security-alert-update.md
- - name: Create comment for alert
+ - name: Create comment
href: ../../api/security-alert-post-comments.md - name: Alert evidence href: ../../resources/security-alertevidence.md
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/teamwork-and-communications/toc.yml a/api-reference/v1.0/toc/teamwork-and-communications/toc.yml
items:
href: ../../api/teamsapp-update.md - name: Delete app from catalog href: ../../api/teamsapp-delete.md
- - name: Get bot associated with app in catalog
+ - name: Get associated bot
href: ../../api/teamworkbot-get.md - name: Teams app installation items:
items:
href: ../../api/participant-mute.md - name: Create href: ../../api/call-post-audioroutinggroups.md
- - name: List audioRoutingGroups
+ - name: List audio routing groups
href: ../../api/call-list-audioroutinggroups.md - name: Add large gallery view href: ../../api/call-addlargegalleryview.md
items:
href: ../../api/channel-post-members.md - name: Get channel member href: ../../api/channel-get-members.md
+ - name: Archive channel
+ href: ../../api/channel-archive.md
+ - name: Unarchive channel
+ href: ../../api/channel-unarchive.md
- name: Update channel member's role href: ../../api/channel-update-members.md - name: Remove channel member
v1.0 Toc.Mapping.Json https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/toc.mapping.json a/api-reference/v1.0/toc/toc.mapping.json
"resources": [ "authenticationStrengthPolicy", "authenticationCombinationConfiguration",
+ "fido2CombinationConfiguration",
+ "x509CertificateCombinationConfiguration",
"authenticationMethodModeDetail" ] },