Updates from: 03/02/2023 02:27:16
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackagecatalog List Customaccesspackageworkflowextensions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagecatalog-list-customaccesspackageworkflowextensions.md
Title: "List customAccessPackageWorkflowExtensions" description: "Get a list of the customAccessPackageWorkflowExtension objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Accesspackagecatalog Post Customaccesspackageworkflowextensions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagecatalog-post-customaccesspackageworkflowextensions.md
Title: "Create customAccessPackageWorkflowExtensions" description: "Create a new customAccessPackageWorkflowExtension object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Accessreview List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-list.md
GET https://graph.microsoft.com/beta/accessReviews?$filter=businessFlowTemplateI
----- ##### Response >**Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Accessreviewinstance Applydecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-applydecisions.md
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitio
[!INCLUDE [sample-code](../includes/snippets/php/accessreviewinstance-applydecisions-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Accessreviewinstance Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-get.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
---- ### Response >**Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Accessreviewinstance Sendreminder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-sendreminder.md
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitio
[!INCLUDE [sample-code](../includes/snippets/php/sendreminder-accessreview-2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Accessreviewinstance Stop https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-stop.md
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitio
[!INCLUDE [sample-code](../includes/snippets/php/stop-accessreviewinstance-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Accessreviewinstancedecisionitem Listpendingapproval https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstancedecisionitem-listpendingapproval.md
GET https://graph.microsoft.com/beta/me/pendingAccessReviewInstances/70a68410-67
---- ### Response >**Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Accessreviewscheduledefinition Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewscheduledefinition-delete.md
DELETE https://graph.microsoft.com/beta/identityGovernance/accessReviews/definit
[!INCLUDE [sample-code](../includes/snippets/php/delete-accessreviewscheduledefinition-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Accessreviewscheduledefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewscheduledefinition-get.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
-- ### Response >**Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Accessreviewset List Definitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewset-list-definitions.md
This method supports the `$select`, `$top`, `$skip`, and `$filter` OData query p
The default page size for this API is 100 **accessReviewScheduleDefinition** objects. To improve efficiency and avoid timeouts due to large result sets, apply pagination using the `$skip` and `$top` query parameters. For more information, see [Paging Microsoft Graph data in your app](/graph/paging). ### Use the $filter query parameter
-The `$filter` query parameter with the `contains` operator is supported on the **scope** property of accessReviewScheduleDefinition. Use the following format for the request:
-
-```http
-GET /identityGovernance/accessReviews/definitions?$filter=contains(scope/microsoft.graph.accessReviewQueryScope/query, '{object}')
-```
-
-The value of `{object}` can be one of the following:
-
-|Value|Description|
-|: |: |
-|/groups |List every accessReviewScheduleDefinition on individual groups (excludes definitions scoped to all Microsoft 365 groups with guest users).|
-|/groups/{group id} |List every accessReviewScheduleDefinition on a specific group (excludes definitions scoped to all Microsoft 365 groups with guest users).|
-|./members |List every accessReviewScheduleDefinition scoped to all Microsoft 365 groups with guest users.|
-|accessPackageAssignments |List every accessReviewScheduleDefinition on an access package.|
-|roleAssignmentScheduleInstances |List every accessReviewScheduleDefinition for service principals assigned to a privileged role.|
-
-The `$filter` query parameter is not supported on **accessReviewInactiveUserQueryScope** or **principalResourceMembershipScope**.
## Request headers None.
v1.0 Accessreviewset Post Historydefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewset-post-historydefinitions.md
The following table shows the required properties used to create an [accessRevie
### Supported scope queries for accessReviewHistoryDefinition
-The **scopes** property of [accessReviewHistoryDefinition](../resources/accessreviewhistorydefinition.md) is based on **accessReviewQueryScope**, a resource that allows you to configure different resources in it's **query** property. These resources then represent the scope of the history definition and dictate the type of review history data that is included in the downloadable CSV file which is generated when the history definition's [accessReviewHistoryInstances](../resources/accessreviewhistoryinstance.md) are created.
-
-Use the following format for the **query** property:
-
-```http
-/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, '{object}')
-```
-
-The value of `{object}` is one of the resources that can be configured in an **accessReviewScheduleDefinition**. For example, the following includes every accessReviewScheduleDefinition review result on individual groups (and excludes definitions scoped to all Microsoft 365 groups with guest users).
-
-```http
-/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, '/groups')
-```
-
-For more supported values, see Use the [$filter query parameter on accessReviewScheduleDefinition](accessreviewset-list-definitions.md#use-the-filter-query-parameter).
## Response
v1.0 Approval Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/approval-get.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
--- ### Response The following is an example of the response.
v1.0 Approval List Steps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/approval-list-steps.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
--- ### Response The following is an example of the response.
v1.0 Approvalstep Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/approvalstep-get.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
--- ### Response The following is an example of the response.
v1.0 Approvalstep Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/approvalstep-update.md
PATCH https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/
--- ### Response The following is an example of the response.
v1.0 Attacksimulationroot Get Excludedaccounttarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-get-excludedaccounttarget.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /security/attackSimulation/simulations/{simulationId}/excludedaccounttarget
+GET /security/attackSimulation/simulations/{simulationId}/excludedAccountTarget
``` ## Request headers
HTTP/1.1 200 OK
Content-Type: application/json {
- "@odata.type": "#microsoft.graph.addressbookaccounttargetcontent",
- "type" : "addressBook",
- "accountTargetEmails" : [
- "john@contoso.com"
- ]
+ "@odata.type": "#microsoft.graph.addressBookAccountTargetContent",
+ "type": "addressBook",
+ "accountTargetEmails": [
+ "john@contoso.com"
+ ]
} ```
v1.0 Attacksimulationroot Get Includedaccounttarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-get-includedaccounttarget.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /security/attackSimulation/simulations/{simulationId}/includedaccounttarget
+GET /security/attackSimulation/simulations/{simulationId}/includedAccountTarget
``` ## Request headers
HTTP/1.1 200 OK
Content-Type: application/json {
- "@odata.type": "#microsoft.graph.addressbookaccounttargetcontent",
- "type" : "addressBook",
- "accountTargetEmails" : [
- "john@contoso.com"
- ]
+ "@odata.type": "#microsoft.graph.addressBookAccountTargetContent",
+ "type": "addressBook",
+ "accountTargetEmails": [
+ "john@contoso.com"
+ ]
} ```
v1.0 Bookingbusiness Getstaffavailability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-getstaffavailability.md
POST /bookingBusinesses/{id}/getStaffAvailability
## Request body
-In the request body, pass the list of staff IDs along with two other parameters of [dateTimeTimeZone resource type](/graph/resources/datetimetimezone) called **startDateTime** and **endDateTime**. These correspond to the two timestamps between which the staff availability will be returned.
+In the request body, pass the list of staff IDs along with two other parameters of [dateTimeTimeZone resource type](/graph/api/resources/datetimetimezone) called **startDateTime** and **endDateTime**. These correspond to the two timestamps between which the staff availability will be returned.
## Response
v1.0 Calendar Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-get.md
Depending on the type of calendar that the event is in and the permission type (
| Calendar | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
-| user calendar | Calendars.Read, Calendars.ReadWrite | Calendars.Read, Calendars.ReadWrite | Calendars.Read, Calendars.ReadWrite |
+| user calendar | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
| group calendar | Group.Read.All, Group.ReadWrite.All | Not supported. | Not supported. |
Content-type: application/json
] } -->+
v1.0 Calendar Getschedule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-getschedule.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.Read, Calendars.ReadWrite |
+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
|Delegated (personal Microsoft account) | Not supported. |
-|Application | Calendars.Read, Calendars.ReadWrite |
+|Application | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Calendar List Calendarpermissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-list-calendarpermissions.md
Depending on the type of calendar that the event is in and the permission type (
| Calendar | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
-| user calendar | Calendars.Read, Calendars.ReadWrite | Calendars.Read, Calendars.ReadWrite | Calendars.Read, Calendars.ReadWrite |
+| user calendar | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
| group calendar | Group.Read.All, Group.ReadWrite.All | Not supported. | Not supported. | ## HTTP request
v1.0 Calendar List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-list-calendarview.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.Read, Calendars.ReadWrite |
-|Delegated (personal Microsoft account) | Calendars.Read, Calendars.ReadWrite |
-|Application | Calendars.Read, Calendars.ReadWrite |
+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
+|Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
+|Application | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Calendar List Events https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-list-events.md
Depending on the type of calendar that the events are in and the permission type
| Calendar | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
-| user calendar | Calendars.Read, Calendars.ReadWrite | Calendars.Read, Calendars.ReadWrite | Calendars.Read, Calendars.ReadWrite |
+| user calendar | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
| group calendar | Group.Read.All, Group.ReadWrite.All | Not supported. | Not supported. |
v1.0 Calendargroup Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendargroup-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the properties and relationships of a calendar group object.
+Retrieve the properties and relationships of a [calendar group](../resources/calendargroup.md) object.
## Permissions
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | | :- | : |
-| Delegated (work or school account) | Calendars.Read |
-| Delegated (personal Microsoft account) | Calendars.Read |
-| Application | Calendars.Read |
+| Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read |
+| Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read |
+| Application | Calendars.ReadBasic, Calendars.Read |
## HTTP request
GET /users/{id | userPrincipalName}/calendarGroups/{id}
## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and [calendarGroup](../resources/calendargroup.md) object in the response body.
+If successful, this method returns a `200 OK` response code and a [calendarGroup](../resources/calendargroup.md) object in the response body.
## Example
-##### Request
-
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/me/calendarGroups/{id}
-##### Response
+### Response
+
+The following is an example of the response.
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
v1.0 Calendargroup List Calendars https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendargroup-list-calendars.md
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | | :- | : |
-| Delegated (work or school account) | Calendars.Read |
-| Delegated (personal Microsoft account) | Calendars.Read |
-| Application | Calendars.Read |
+| Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read |
+| Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read |
+| Application | Calendars.ReadBasic, Calendars.Read |
## HTTP request
v1.0 Calendarpermission Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendarpermission-get.md
Depending on the type of calendar that the event is in and the permission type (
| Calendar | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
-| user calendar | Calendars.Read, Calendars.ReadWrite | Calendars.Read, Calendars.ReadWrite | Calendars.Read, Calendars.ReadWrite |
+| user calendar | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic,Calendars.Read, Calendars.ReadWrite | Calendars.Read, Calendars.ReadWrite |
| group calendar | Group.Read.All, Group.ReadWrite.All | Not supported. | Not supported. | ## HTTP request
v1.0 Call Addlargegalleryview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-addlargegalleryview.md
Namespace: microsoft.graph
Add the large gallery view to a call.
-For details about how to identify a large gallery view participant in a roster so that you can retrieve the relevant data to subscribe to the video feed, see [Identify large gallery view participants in a roster](https://learn.microsoft.com/en-us/graph/cloud-communications-identifylargegalleryview).
+For details about how to identify a large gallery view participant in a roster so that you can retrieve the relevant data to subscribe to the video feed, see [Identify large gallery view participants in a roster](/graph/cloud-communications-identifylargegalleryview).
## 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).
v1.0 Callrecords Callrecord Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/callrecords-callrecord-get.md
Title: "Get callRecord" description: "Retrieve the properties and relationships of callrecord object." ms.localizationpriority: medium-+ ms.prod: "cloud-communications" doc_type: "apiPageType"
The following is an example of the request to get the basic details from a [call
"name": "get_callrecord" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/beta/communications/callRecords/{id} ```
The following is an example of the request to get the full details from a [callR
"name": "get_callrecord_expanded" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/beta/communications/callRecords/{id}?$expand=sessions($expand=segments) ```
v1.0 Calltranscript Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calltranscript-get.md
Retrieve a [callTranscript](../resources/calltranscript.md) object associated wi
Retrieving the transcript returns the metadata of the single transcript associated with the online meeting. Retrieving the content of the transcript returns the stream of text associated with the transcript.
-> **Note:** In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
+> **Notes:**
+> - In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
+> - This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
## Permissions
One of the following permissions is required to call this API. To learn more, in
To use application permission for this API, tenant administrators must create an application access policy and grant it to a user. This authorizes the app configured in the policy to fetch online meetings and/or online meeting artifacts on behalf of that user (with the user ID specified in the request path). For more details, see [Allow applications to access online meetings on behalf of a user](/graph/cloud-communication-online-meeting-application-access-policy). > [!NOTE]
-> This API would work for a meeting only if the meeting has not expired. For more details, see [Limits and specifications for Microsoft Teams](/microsoftteams/limits-specifications-teams#meeting-expiration).
+> This API works for a meeting only if the meeting has not expired. For more details, see [Limits and specifications for Microsoft Teams](/microsoftteams/limits-specifications-teams#meeting-expiration).
## HTTP request
To use application permission for this API, tenant administrators must create an
Get a single transcript of an online meeting. ```http
-GET /me/onlineMeetings({meetingId})/transcripts({transcriptId})
-GET /users({userId})/onlineMeetings({meetingId})/transcripts({transcriptId})
+GET /me/onlineMeetings/{meetingId}/transcripts/{transcriptId}
+GET /users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}
``` Get the content of a single transcript of an online meeting. ```http
-GET me/onlineMeetings({meetingId})/transcripts({transcriptId})/content
-GET users({userId})/onlineMeetings({meetingId})/transcripts({transcriptId})/content
+GET me/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content
+GET users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content
``` ## Request headers
v1.0 Channel Getallmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-getallmessages.md
Retrieve [messages](../resources/chatmessage.md) across all [channels](../resour
To learn more about using the Microsoft Teams export APIs to export content, see [Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content). ## Permissions
v1.0 Channel Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-post.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-channel-from-group-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-private-channel-with-member-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-channel-with-moderation-settings-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
v1.0 Chart Image https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chart-image.md
You can display the base-64 string inside an HTML image tag: `<img src="data:ima
For default behavior, use `Image(width=0,height=0,fittingMode='fit')`. Here is an example of a chart image returned with the default parameters.
-![Screenshot of an Excel chart image displayed with the default height and width.](https://cdn.graph.office.net/prod/GraphDocuments/concepts/images/GetChart-default.png)
+ If you want to customize the display of the image, specify a height, width, and a fitting mode. Here is what the same chart image looks like if you retrieve it with these parameters: `Image(width=500,height=500,fittingMode='Fill')`.
-![Screenshot of an Excel chart image displayed with the specified height and width.](https://github.com/microsoftgraph/microsoft-graph-docs/blob/main/concepts/images/GetChart-fill.png)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Chat Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-get.md
The following is an example of the request.
<!-- { "blockType": "request", "name": "get_meeting_chat",
- "sampleKeys": ["19:meeting_ZDZlYTYxOWUtYzdlMi00ZmMxLWIxMTAtN2YzODZlZjAxYzI4@thread.v2"]
+ "sampleKeys": ["19:ebe3857aa388434bab0cad9d2e09f4de@thread.v2"]
}--> ```msgraph-interactive GET https://graph.microsoft.com/beta/chats/19:ebe3857aa388434bab0cad9d2e09f4de@thread.v2?$expand=lastMessagePreview
GET https://graph.microsoft.com/beta/chats/19:ebe3857aa388434bab0cad9d2e09f4de@t
--- #### Response The following example shows the response.
v1.0 Chat List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-messages.md
Retrieve the list of [messages](../resources/chatmessage.md) in a [chat](../reso
This method supports federation. To list chat messages in application context, the request must be made from the tenant that the channel owner belongs to (represented by the **tenantId** property on the channel).
-> **Note**: This API supports subscribing to changes (create, update, and delete) using [change notifications](../resources/webhooks.md). This allows callers to subscribe and get changes in real time. For details, see [Get notifications for messages](/graph/teams-changenotifications-chatmessage).
+> **Notes**:
+> - This API supports subscribing to changes (create, update, and delete) using [change notifications](../resources/webhooks.md). This allows callers to subscribe and get changes in real time. For details, see [Get notifications for messages](/graph/teams-changenotifications-chatmessage).
+> - This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
## Permissions
v1.0 Chat List Operations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-operations.md
GET https://graph.microsoft.com/beta/chats/19:c253a29b5f694b55a6baad8e83510af7@t
[!INCLUDE [sample-code](../includes/snippets/php/list-chat-operations-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Chat List Permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-permissiongrants.md
GET https://graph.microsoft.com/beta/chats/19:089ac694c48647c68035aae675cf78ab@t
[!INCLUDE [sample-code](../includes/snippets/php/chat-list-permission-grants-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Chat List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list.md
Retrieve the list of [chats](../resources/chat.md) that the user is part of.
This method supports federation. When a user ID is provided, the calling application must belong to the same tenant that the user belongs to.
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
This method supports the following [OData query parameters](/graph/query-paramet
The other [OData query parameters](/graph/query-parameters) are not currently supported.
+> [!NOTE]
+> The `$top` query parameter might not return all chats within a single response object. If the result set for all chats spans multiple pages, the response object includes an **@odata.nextLink** property that contains a URL to the next page of results. If that property is present, continue making additional requests with the **@odata.nextLink** URL in each response, until all the results are returned.
+ ## Request headers | Header | Value |
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
[!INCLUDE [sample-code](../includes/snippets/php/list-chats-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
[!INCLUDE [sample-code](../includes/snippets/php/list-chats-expand-members-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
[!INCLUDE [sample-code](../includes/snippets/php/list-chats-expand-members-and-filter-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
GET https://graph.microsoft.com/beta/chats?$orderBy=lastMessagePreview/createdDa
[!INCLUDE [sample-code](../includes/snippets/php/list-chats-orderby-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
v1.0 Chat Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post-members.md
content-type: application/json
---- #### Response Here is an example of the response.
Content-type: application/json
---- #### Response Here is an example of the response.
content-type: application/json
---- #### Response Here is an example of the response.
v1.0 Chat Post Pinnedmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post-pinnedmessages.md
Content-Type: application/json
"id": "1616964509832" } ```+
+## See also
+
+- [Pinned message C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-pinned-messages/csharp)
+- [Pinned message Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-pinned-messages/nodejs)
v1.0 Chat Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-chat-oneonone-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-a-group-chat-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-chat-oneonone-with-installed-apps-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-chat-group-with-tenant-guest-user-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
v1.0 Chat Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-sendactivitynotification.md
Content-Type: application/json
- #### Response The following example shows the response.
The following example shows the response.
``` http HTTP/1.1 204 No Content ```+
+## See also
+
+- [Activity feed notification C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/csharp)
+- [Activity feed notification Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/nodejs)
v1.0 Chatmessage Post Replies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-post-replies.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | ChannelMessage.Send, Group.ReadWrite.All** | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Teamwork.Migrate.All, ChannelMessage.ReadWrite.All |
+| Application | Teamwork.Migrate.All |
> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-post.md
Content-type: application/json
} ```
+### Example 11: Send a message that contains an announcement
+
+#### Request
+
+The following is an example of the request.
+
+> **Note:** The Base64-encoded value for the **contentBytes** property is shortened for readability.
+
+<!-- {
+ "blockType": "request",
+ "name": "post_chatmessage_11",
+ "sampleKeys": ["5c884e2f-83f8-4cff-af8e-0177f260b9f8", "19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2"]
+}-->
+
+```http
+POST https://graph.microsoft.com/beta/teams/5c884e2f-83f8-4cff-af8e-0177f260b9f8/channels/19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2/messages
+Content-type: application/json
+
+{
+ "subject": "Announcement Subheading",
+ "body": {
+ "contentType": "text",
+ "content": "<attachment id=\"d7ddbf876ae340c3a03bada395ec7da7\"></attachment>Announcement text"
+ },
+ "attachments": [
+ {
+ "id": "d7ddbf876ae340c3a03bada395ec7da7",
+ "contentType": "application/vnd.microsoft.teams.messaging-announcementBanner",
+ "contentUrl": null,
+ "content": "{\"title\":\"Announcement heading\",\"cardImageType\":\"uploadedImage\",\"cardImageDetails\":{\"uploadedImageDetail\":{\"originalImage\":{\"source\":\"../hostedContents/1/$value\",\"width\":1379,\"height\":268,\"croppedWidth\":918.0,\"croppedHeight\":178.4075416968818,\"leftMargin\":0.0,\"topMargin\":90.7962291515591,\"imageContentType\":\"image/png\"},\"croppedImage\":{\"source\":\"../hostedContents/2/$value\"}}}}",
+ "name": null,
+ "thumbnailUrl": null
+ }
+ ],
+ "hostedContents": [
+ {
+ "@microsoft.graph.temporaryId": "1",
+ "contentBytes": "iVBORw0KGgoAAAANSUhEUgAABWMAAAEMCAYAAAChuaTsAAAAAXNSR0IArs4c6QAAAARnQU1BA",
+ "contentType": "image/png"
+ },
+ {
+ "@microsoft.graph.temporaryId": "2",
+ "contentBytes": "iVBORw0KGgoAAAANSUhEUgAAA5YAAAB4CAYAAACJrW0RAAAAAXNSR0IArs4c6QAAIABJREFUe",
+ "contentType": "image/png"
+ }
+ ]
+}
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.chatMessage"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('5c884e2f-83f8-4cff-af8e-0177f260b9f8')/channels('19%3A81f49626414645c99469ee65a1a7e1a4%40thread.tacv2')/messages/$entity",
+ "id": "1675104302171",
+ "replyToId": null,
+ "etag": "1675104302171",
+ "messageType": "message",
+ "createdDateTime": "2023-01-30T18:45:02.171Z",
+ "lastModifiedDateTime": "2023-01-30T18:45:02.171Z",
+ "lastEditedDateTime": null,
+ "deletedDateTime": null,
+ "subject": "Announcement Subheading",
+ "summary": null,
+ "chatId": null,
+ "importance": "normal",
+ "locale": "en-us",
+ "webUrl": "https://teams.microsoft.com/l/message/19%3A81f49626414645c99469ee65a1a7e1a4%40thread.tacv2/1675104302171?groupId=5c884e2f-83f8-4cff-af8e-0177f260b9f8&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1675104302171&parentMessageId=1675104302171",
+ "onBehalfOf": null,
+ "policyViolation": null,
+ "eventDetail": null,
+ "from": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "28c10244-4bad-4fda-993c-f332faef94f0",
+ "displayName": "Test user",
+ "userIdentityType": "aadUser"
+ }
+ },
+ "body": {
+ "contentType": "text",
+ "content": "<attachment id=\"d7ddbf876ae340c3a03bada395ec7da7\"></attachment>Announcement text"
+ },
+ "channelIdentity": {
+ "teamId": "5c884e2f-83f8-4cff-af8e-0177f260b9f8",
+ "channelId": "19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2"
+ },
+ "attachments": [
+ {
+ "id": "d7ddbf876ae340c3a03bada395ec7da7",
+ "contentType": "application/vnd.microsoft.teams.messaging-announcementBanner",
+ "contentUrl": null,
+ "content": "{\"title\":\"Announcement heading\",\"cardImageType\":\"uploadedImage\",\"cardImageDetails\":{\"uploadedImageDetail\":{\"originalImage\":{\"source\":\"https://graph.microsoft.com/beta/teams/5c884e2f-83f8-4cff-af8e-0177f260b9f8/channels/19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2/messages/1675104302171/hostedContents/aWQ9LHR5cGU9MSx1cmw9aHR0cHM6Ly91cy1hcGkuYXNtLnNreXBlLmNvbS92MS9vYmplY3RzLzAtd3VzLWQyLTY3OTJlM2ExMzFmNzc4YjY5NWMwYTE5ZGRkZmIwYWNiL3ZpZXdzL2ltZ28=/$value\",\"width\":1379,\"height\":268,\"croppedWidth\":918.0,\"croppedHeight\":178.4075416968818,\"leftMargin\":0.0,\"topMargin\":90.7962291515591,\"imageContentType\":\"image/png\"},\"croppedImage\":{\"source\":\"https://graph.microsoft.com/beta/teams/5c884e2f-83f8-4cff-af8e-0177f260b9f8/channels/19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2/messages/1675104302171/hostedContents/aWQ9LHR5cGU9MSx1cmw9aHR0cHM6Ly91cy1hcGkuYXNtLnNreXBlLmNvbS92MS9vYmplY3RzLzAtd3VzLWQzLTAwYjhhNWZiZTA0MGRmY2MzMWZkNzM1ZDE4Yjk4NTM5L3ZpZXdzL2ltZ28=/$value\"}}}}",
+ "name": null,
+ "thumbnailUrl": null,
+ "teamsAppId": null
+ }
+ ],
+ "mentions": [],
+ "reactions": []
+}
+
+```
+
+### Example 12: Send a message with an emoji
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "post_chatmessage_12",
+ "sampleKeys": ["19:7fb82b685f9c457296a0ab6a1d98b4c1@thread.v2"]
+}-->
+
+```http
+POST https://graph.microsoft.com/beta/chats/19:7fb82b685f9c457296a0ab6a1d98b4c1@thread.v2/messages
+Content-type: application/json
+
+{
+ "body": {
+ "contentType": "html",
+ "content": "<emoji alt=\"😶‍🌫️\"></emoji>"
+ }
+}
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.chatMessage"
+} -->
+
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://canary.graph.microsoft.com/testprodbetateamsgraphsumanach/$metadata#chats('19%3A7fb82b685f9c457296a0ab6a1d98b4c1%40thread.v2')/messages/$entity",
+ "id": "1675459162626",
+ "replyToId": null,
+ "etag": "1675459162626",
+ "messageType": "message",
+ "createdDateTime": "2023-02-03T21:19:22.626Z",
+ "lastModifiedDateTime": "2023-02-03T21:19:22.626Z",
+ "lastEditedDateTime": null,
+ "deletedDateTime": null,
+ "subject": null,
+ "summary": null,
+ "chatId": "19:7fb82b685f9c457296a0ab6a1d98b4c1@thread.v2",
+ "importance": "normal",
+ "locale": "en-us",
+ "webUrl": null,
+ "channelIdentity": null,
+ "onBehalfOf": null,
+ "policyViolation": null,
+ "eventDetail": null,
+ "from": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "28c10244-4bad-4fda-993c-f332faef94f0",
+ "displayName": "Test User",
+ "userIdentityType": "aadUser"
+ }
+ },
+ "body": {
+ "contentType": "html",
+ "content": "<emoji id=\"faceinclouds\" alt=\"😶‍🌫️\" title=\"Face in clouds\"></emoji>"
+ },
+ "attachments": [],
+ "mentions": [],
+ "reactions": []
+}
+```
+ ## See also -- [Cards reference](/microsoftteams/platform/concepts/cards/cards-reference)
+* [Cards reference](/microsoftteams/platform/concepts/cards/cards-reference)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Chatmessage Setreaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-setreaction.md
Title: "chatMessage: setReaction" description: "Set a reaction to a single message or message reply in a channel or a chat."-+ ms.prod: "microsoft-teams" doc_type: apiPageType ms.localizationpriority: medium
v1.0 Chatmessage Softdelete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-softdelete.md
Title: "chatMessage: softDelete" description: "Delete a single message or message reply in a channel or a chat."-+ ms.prod: "microsoft-teams" doc_type: apiPageType ms.localizationpriority: medium
Namespace: microsoft.graph
Delete a single [message](../resources/chatmessage.md) or a [message reply](../resources/chatmessage.md) in a [channel](../resources/channel.md) or a [chat](../resources/chat.md).
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
v1.0 Chatmessage Undosoftdelete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-undosoftdelete.md
Title: "chatMessage: undoSoftDelete" description: "Undelete a single message or a message reply in a channel or a chat."-+ ms.prod: "microsoft-teams" doc_type: apiPageType ms.localizationpriority: medium
v1.0 Chatmessage Unsetreaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-unsetreaction.md
Title: "chatMessage: unsetReaction" description: "Unset areaction to a single message or message reply in a channel or a chat."-+ ms.prod: "microsoft-teams" doc_type: apiPageType ms.localizationpriority: medium
v1.0 Chatmessage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-update.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | ChannelMessage.ReadWrite, Group.ReadWrite.All** | | Delegated (personal Microsoft account) | Not supported. |
-| Application | ChannelMessage.UpdatePolicyViolation.All, ChannelMessage.ReadWrite.All, Group.ReadWrite.All** |
+| Application | ChannelMessage.UpdatePolicyViolation.All, Group.ReadWrite.All** |
> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
v1.0 Chats Getallmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chats-getallmessages.md
Namespace: microsoft.graph
Get all messages from all [chats](../resources/chatmessage.md) that a user is a participant in, including one-on-one chats, group chats, and meeting chats. ## Permissions
GET /users/{id | user-principal-name}/chats/getAllMessages
## Optional query parameters
-You can use `model` query parameter, which supports the values `A` and `B`, based on the preferred [licensing and payment model](/graph/teams-licenses),
-as shown in the following examples.
-If no `model` is specified, [evaluation mode](/graph/teams-licenses#evaluation-mode-default-requirements) will be used.
+This method supportsΓÇ»[date range parameters](/graph/query-parameters) to customize the response, as shown in the following example.
```http
-GET /users/{id | user-principal-name}/chats/getAllMessages?model=A
-GET /users/{id | user-principal-name}/chats/getAllMessages?model=B
+GET /users/{id}/chats/getAllMessages?$top=50&$filter=lastModifiedDateTime gt 2020-06-04T18:03:11.591Z and lastModifiedDateTime lt 2020-06-05T21:00:09.413Z
```-
-This operation supportsΓÇ»[date range parameters](/graph/query-parameters) to customize the response, as shown in the following example.
+Use the `model` query parameter to specify the [payment model](/graph/teams-licenses) that applies to your scenario, as shown in the following examples.
```http
-GET /users/{id}/chats/getAllMessages?$top=50&$filter=lastModifiedDateTime gt 2020-06-04T18:03:11.591Z and lastModifiedDateTime lt 2020-06-05T21:00:09.413Z
+GET /users/{id | user-principal-name}/chats/getAllMessages?model=A
+GET /users/{id | user-principal-name}/chats/getAllMessages?model=B
```
+>**Note:** If you don't specify a payment model in your query, the default [evaluation mode](/graph/teams-licenses#evaluation-mode-default-requirements) will be used.
## Request headers | Header | Value |
v1.0 Cloudpc Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpc-get.md
Content-Type: application/json
"userPrincipalName": "pmitchell@cpccustomer001.onmicrosoft.com", "lastModifiedDateTime": "2020-11-03T18:14:34Z", "gracePeriodEndDateTime": "2020-11-010T20:00:34Z",
+ "provisioningType": "shared",
"diskEncryptionState": "notAvailable" } ```
Content-Type: application/json
"userPrincipalName": "pmitchell@cpccustomer001.onmicrosoft.com", "lastModifiedDateTime": "2020-11-03T18:14:34Z", "gracePeriodEndDateTime": "2020-11-010T20:00:34Z",
+ "provisioningType": "shared",
"diskEncryptionState": "notAvailable" } ```
v1.0 Cloudpc Retrypartneragentinstallation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpc-retrypartneragentinstallation.md
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/
--- #### Response <!-- {
v1.0 Cloudpcorganizationsettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcorganizationsettings-get.md
Content-Type: application/json
"value": { "@odata.type": "#microsoft.graph.cloudPcOrganizationSettings", "enableMEMAutoEnroll": false,
+ "enableSingleSignOn": true,
"id": "8660bf17-bf17-8660-17bf-608617bfffff", "osVersion": "windows11", "userAccountType": "standardUser",
v1.0 Cloudpcorganizationsettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcorganizationsettings-update.md
PATCH /deviceManagement/virtualEndpoint/organizationSettings
|Property|Type|Description| |:|:|:| |enableMEMAutoEnroll|Boolean|Specifies whether new Cloud PCs will be automatically enrolled in Microsoft Endpoint Manager(MEM). The default value is `false`. Optional.|
+|enableSingleSignOn|Boolean|`True` if the provisioned Cloud PC can be accessed by single sign-on. `False` indicates that the provisioned Cloud PC doesn't support this feature. Default value is `false`. Windows 365 users can use single sign-on to authenticate to Azure Active Directory (Azure AD) with passwordless options (for example, FIDO keys) to access their Cloud PC. Optional.|
|osVersion|cloudPcOperatingSystem|The version of the operating system (OS) to provision on Cloud PCs. The possible values are: `windows10`, `windows11`, `unknownFutureValue`. Optional.| |userAccountType|cloudPcUserAccountType|The account type of the user on provisioned Cloud PCs. The possible values are: `standardUser`, `administrator`, `unknownFutureValue`. Optional.| |windowsSettings|cloudPcWindowsSettings|The settings to apply to Windows while creating Cloud PCs for this organization. The default language value is `en-US`.| - ## Response If successful, this method returns a `204 No Content` response code.
If successful, this method returns a `204 No Content` response code.
### Request
+The following is an example of a request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
Content-length: 127
+### Response
+The following is an example of the response.
-### Response
<!-- { "blockType": "response", "truncated": true
v1.0 Cloudpcprovisioningpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcprovisioningpolicy-get.md
Content-Type: application/json
"domainJoinType": "hybridAzureADJoin", "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff" },
+ "enableSingleSignOn": true,
"id": "1d164206-bf41-4fd2-8424-a3192d39ffff", "imageDisplayName": "Image Display Name value", "imageId": "Image ID value",
Content-Type: application/json
"windowsSettings": { "language": "en-US" },
- "managedBy": "windows365"
+ "managedBy": "windows365",
+ "provisioningType": "dedicated"
} ```
Content-Type: application/json
"regionName": null, "type": "hybridAzureADJoin" },
+ "enableSingleSignOn": true,
"id": "1d164206-bf41-4fd2-8424-a3192d39ffff", "imageDisplayName": "Image Display Name value", "imageId": "Image ID value",
Content-Type: application/json
} } ],
- "managedBy": "windows365"
+ "managedBy": "windows365",
+ "provisioningType": "dedicated"
} ```
Content-Type: application/json
"regionName": null, "type": "hybridAzureADJoin" },
+ "enableSingleSignOn": true,
"gracePeriodInHours": 2, "id": "1d164206-bf41-4fd2-8424-a3192d39ffff", "imageDisplayName": "myCustomImage",
Content-Type: application/json
"onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff", "windowsSettings": { "language": "en-US"
- }
+ },
+ "provisioningType": "dedicated"
} ```
v1.0 Cloudpcprovisioningpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcprovisioningpolicy-update.md
The following table shows the properties that can be updated for the [cloudPcPro
|Property|Type|Description| |:|:|:|
-|displayName|String|The display name for the provisioning policy. |
|description|String|The provisioning policy description.|
+|displayName|String|The display name for the provisioning policy. |
|domainJoinConfiguration|[cloudPcDomainJoinConfiguration](../resources/cloudpcdomainjoinconfiguration.md)|Specifies how Cloud PCs will join Azure Active Directory.|
-|onPremisesConnectionId|String|The ID of the cloudPcOnPremisesConnection. To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network thatΓÇÖs validated by the Cloud PC service.|
+|enableSingleSignOn|Boolean|`True` if the provisioned Cloud PC can be accessed by single sign-on. `False` indicates that the provisioned Cloud PC doesn't support this feature. Default value is `false`. Windows 365 users can use single sign-on to authenticate to Azure Active Directory (Azure AD) with passwordless options (for example, FIDO keys) to access their Cloud PC. Optional.|
+|imageDisplayName|String|The display name for the OS image you're provisioning.|
|imageId|String|The ID of the OS image you want to provision on Cloud PCs. The format for a gallery type image is: {publisher_offer_sku}. Supported values for each of the parameters are as follows: <ul><li>publisher: Microsoftwindowsdesktop.</li> <li>offer: windows-ent-cpc.</li> <li>sku: 21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-m365, 20h1-ent-cpc-os, 19h2-ent-cpc-m365 and 19h2-ent-cpc-os.</li></ul>|
-|imageDisplayName|String|The display name for the OS image youΓÇÖre provisioning.|
|imageType|cloudPcProvisioningPolicyImageType|The type of OS image (custom or gallery) you want to provision on Cloud PCs. Possible values are: `gallery`, `custom`.|
+|onPremisesConnectionId|String|The ID of the cloudPcOnPremisesConnection. To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network thatΓÇÖs validated by the Cloud PC service.|
|windowsSettings|[cloudPcWindowsSettings](../resources/cloudpcwindowssettings.md)|The Windows operation system settings for the provisioned Cloud PCs with this provisioning policy, such as operation system language setting.| ## Response
If successful, this method returns a `204 No Content` response code.
### Request
+The following is an example of a request.
# [HTTP](#tab/http) <!-- {
Content-Type: application/json
- ### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "truncated": true,
v1.0 Cloudpcshareduseserviceplan Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcshareduseserviceplan-get.md
+
+ Title: "Get cloudPcSharedUseServicePlan"
+description: "Read the properties and relationships of a cloudPcSharedUseServicePlan object."
+
+ms.localizationpriority: medium
++
+# Get cloudPcSharedUseServicePlan
+
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | CloudPC.Read.All, CloudPC.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | CloudPC.Read.All, CloudPC.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceManagement/virtualEndpoint/sharedUseServicePlans/{cloudPcSharedUseServicePlanId}
+```
+
+## Optional query parameters
+
+This method supports the `$select` OData query parameter to help customize the response.. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_cloudpcshareduseserviceplan"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/sharedUseServicePlans/613a8d85-6c33-1268-9f55-b96a6540017c
+```
+
+### Response
+
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.cloudPcSharedUseServicePlan"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.cloudPcSharedUseServicePlan",
+ "id": "613a8d85-6c33-1268-9f55-b96a6540017c",
+ "displayName": "Display Name Value",
+ "usedCount": "10",
+ "totalCount": "20"
+ }
+}
+```
v1.0 Contenttype Post Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/contenttype-post-columns.md
Add a column to a [content type][contentType] in a site or list by specifying a
## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/concepts/permissions_reference.md).
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Customaccesspackageworkflowextension Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/customaccesspackageworkflowextension-delete.md
Title: "Delete customAccessPackageWorkflowExtension" description: "Delete a customAccessPackageWorkflowExtension object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Customaccesspackageworkflowextension Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/customaccesspackageworkflowextension-get.md
Title: "Get customAccessPackageWorkflowExtension" description: "Read the properties and relationships of a customAccessPackageWorkflowExtension object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Customaccesspackageworkflowextension Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/customaccesspackageworkflowextension-update.md
Title: "Update customAccessPackageWorkflowExtension" description: "Update the properties of a customAccessPackageWorkflowExtension object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Device Delete Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-delete-registeredowners.md
DELETE https://graph.microsoft.com/beta/devices/{id}/registeredOwners/{id}/$ref
[!INCLUDE [sample-code](../includes/snippets/php/delete-registeredowners-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Device Delete Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-delete-registeredusers.md
One of the following permissions is required to call this API. To learn more, in
[!INCLUDE [limited-info](../../includes/limited-info.md)]
+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference): *Global Administrator*, *Intune Administrator*, or *Windows 365 Administrator*.
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
DELETE https://graph.microsoft.com/beta/devices/{id}/registeredUsers/{id}/$ref
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Device Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-delete.md
Title: "Delete device" description: "Delete a registered device."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+* Global Administrator
+* Users
+* Directory Readers
+* Directory Writers
+* Compliance Administrator
+* Device Managers
+* Application Administrator
+* Security Reader
+* Security Administrator
+* Privileged Role Administrator
+* Cloud Application Administrator
+* Customer LockBox Access Approver
+* Dynamics 365 Administrator
+* Power BI Administrator
+* Desktop Analytics Administrator
+* Microsoft Managed Desktop Administrator
+* Teams Communications Administrator
+* Teams Communications Support Engineer
+* Teams Communications Support Specialist
+* Teams Administrator
+* Compliance Data Administrator
+* Security Operator
+* Kaizala Administrator
+* Global Reader
+* Directory Reviewer
+* Windows 365 Administrator
+ ## HTTP request You can address the device using either its **id** or **deviceId**.
v1.0 Device List Memberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-list-memberof.md
Title: "List memberOf" description: "Get groups or administrative units that this device is a direct member of. This operation is not transitive."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device List Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-list-registeredowners.md
Title: "List registeredOwners" description: "Retrieve a list of users that are registered owners of the device." ms.localizationpriority: medium-+ ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device List Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-list-registeredusers.md
Title: "List registeredUsers" description: "Retrieve a list of users that are registered users of the device."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
[!INCLUDE [limited-info](../../includes/limited-info.md)]
+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+* Global Administrator
+* Users
+* Directory Readers
+* Directory Writers
+* Compliance Administrator
+* Device Managers
+* Application Administrator
+* Security Reader
+* Security Administrator
+* Privileged Role Administrator
+* Cloud Application Administrator
+* Customer LockBox Access Approver
+* Dynamics 365 Administrator
+* Power BI Administrator
+* Desktop Analytics Administrator
+* Microsoft Managed Desktop Administrator
+* Teams Communications Administrator
+* Teams Communications Support Engineer
+* Teams Communications Support Specialist
+* Teams Administrator
+* Compliance Data Administrator
+* Security Operator
+* Kaizala Administrator
+* Global Reader
+* Directory Reviewer
+* Windows 365 Administrator
+ ## HTTP request You can address the device using either its **id** or **deviceId**.
v1.0 Device List Transitivememberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-list-transitivememberof.md
Title: "List device transitive memberships" description: "Get groups and administrative units that the device is a member of." ms.localizationpriority: medium-+ ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-list.md
One of the following permissions is required to call this API. To learn more, in
| Delegated (personal Microsoft account) | Not supported. | | Application | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+* Global Administrator
+* Users
+* Directory Readers
+* Directory Writers
+* Compliance Administrator
+* Device Managers
+* Application Administrator
+* Security Reader
+* Security Administrator
+* Privileged Role Administrator
+* Cloud Application Administrator
+* Customer LockBox Access Approver
+* Dynamics 365 Administrator
+* Power BI Administrator
+* Desktop Analytics Administrator
+* Microsoft Managed Desktop Administrator
+* Teams Communications Administrator
+* Teams Communications Support Engineer
+* Teams Communications Support Specialist
+* Teams Administrator
+* Compliance Data Administrator
+* Security Operator
+* Kaizala Administrator
+* Global Reader
+* Directory Reviewer
+* Windows 365 Administrator
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Device Post Devices https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-post-devices.md
Title: "Create device" description: "Create a new device."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device Post Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-post-registeredowners.md
Title: "Create registeredOwner" description: "Add a user as a registered owner of the device."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device Post Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-post-registeredusers.md
Title: "Create registeredUser" description: "Add a registered user for the device."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Not supported. |
+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference): *Global Administrator*, *Intune Administrator*, or *Windows 365 Administrator*.
+ ## HTTP request You can address the device using either its **id** or **deviceId**.
v1.0 Directory Deleteditems Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-delete.md
If successful, this method returns `204 No Content` response code. It does not r
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "delete_directory"
+ "name": "delete_directory_deleteditem"
}--> ```http DELETE https://graph.microsoft.com/beta/directory/deleteditems/46cc6179-19d0-473e-97ad-6ff84347bbbb
v1.0 Directory Deleteditems Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-get.md
The following is an example of a request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "get_directory"
+ "name": "get_directory_deleteditem"
}--> ```msgraph-interactive GET https://graph.microsoft.com/beta/directory/deleteditems/46cc6179-19d0-473e-97ad-6ff84347bbbb
v1.0 Directory Deleteditems Getuserownedobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-getuserownedobjects.md
Successful requests return `200 OK` response codes; the response object includes
## Example
-##### Request
+### Request
Here is an example of the request.
+<!-- {
+ "blockType": "request",
+ "name": "get_directory_deleteditem_getuserownedobjects"
+}-->
``` http POST https://graph.microsoft.com/beta/directory/deletedItems/getUserOwnedObjects Content-type: application/json
Content-type: application/json
} ```
-###### Response
+### Response
-Here is an example of the response. Note: This response object may be truncated for brevity. All supported properties are returned
-from actual calls.
+Here is an example of the response.
+> **Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.directoryObject",
+ "isCollection": true
+} -->
``` http
-HTTP/1.1 200
+HTTP/1.1 200 OK
Content-type: application/json {
-"value": [
- {
- "@odata.type": "#microsoft.graph.group",
- "id": "bfa7033a-7367-4644-85f5-95aaf385cbd7",
- "deletedDateTime": "2018-04-01T12:39:16Z",
- "classification": null,
- "createdDateTime": "2017-03-22T12:39:16Z",
- "description": null,
- "displayName": "Test",
- "groupTypes": [
- "Unified"
- ],
- "mail": "Test@contoso.com",
- "mailEnabled": true,
- "mailNickname": "Test",
- "membershipRule": null,
- "membershipRuleProcessingState": null,
- "preferredDataLocation": null,
- "preferredLanguage": null,
- "proxyAddresses": [
- "SMTP:Test@contoso.com"
- ],
- "renewedDateTime": "2017-09-22T22:30:39Z",
- "securityEnabled": false,
- "theme": null,
- "visibility": "Public"
- }
- ]
- }
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.group",
+ "id": "bfa7033a-7367-4644-85f5-95aaf385cbd7",
+ "deletedDateTime": "2018-04-01T12:39:16Z",
+ "classification": null,
+ "createdDateTime": "2017-03-22T12:39:16Z",
+ "description": null,
+ "displayName": "Test",
+ "groupTypes": [
+ "Unified"
+ ],
+ "mail": "Test@contoso.com",
+ "mailEnabled": true,
+ "mailNickname": "Test",
+ "membershipRule": null,
+ "membershipRuleProcessingState": null,
+ "preferredDataLocation": null,
+ "preferredLanguage": null,
+ "proxyAddresses": [
+ "SMTP:Test@contoso.com"
+ ],
+ "renewedDateTime": "2017-09-22T22:30:39Z",
+ "securityEnabled": false,
+ "theme": null,
+ "visibility": "Public"
+ }
+ ]
+}
```
v1.0 Directory Deleteditems List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-list.md
If successful, this method returns a `200 OK` response code and collection of [d
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "get_deleteditems"
+ "name": "list_directory_deleteditems"
}--> ```msgraph-interactive GET https://graph.microsoft.com/beta/directory/deleteditems/microsoft.graph.group
Content-type: application/json
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "get_deleteditems_count"
+ "name": "list_directory_deleteditems_count"
}--> ```msgraph-interactive GET https://graph.microsoft.com/beta/directory/deletedItems/microsoft.graph.group?$count=true&$orderBy=deletedDateTime asc&$select=id,displayName,deletedDateTime
v1.0 Directory Deleteditems Restore https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-restore.md
The calling app must be assigned one of the following [Azure AD roles](/azure/ac
|Delegated (personal Microsoft account) | Not supported. | |Application | User.ReadWrite.All |
+To restore users with privileged administrator roles in delegated scenarios, the app must be assigned with *Directory.AccessAsUser.All* delegated permission, and the calling user must also be assigned a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).
+
+In app-only scenarios, the *User.ReadWrite.All* application permission isn't enough privilege to restore deleted users with privileged administrator roles. The app must be assigned a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).
+ ### For groups: |Permission type | Permissions (from least to most privileged) |
If successful, this method returns a `200 OK` response code and a [directoryObje
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "create_directoryobject_from_directory"
+ "name": "restore_directory_deleteditem"
}--> ```http POST https://graph.microsoft.com/beta/directory/deleteditems/46cc6179-19d0-473e-97ad-6ff84347bbbb/restore
v1.0 Domain Post Federationconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-post-federationconfiguration.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported| |Application|Domain.ReadWrite.All|
-The calling user must be assigned the Global Administrator [Azure AD role](/azure/active-directory/roles/permissions-reference).
+The calling user must be assigned one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+- Security Administrator
+- External Identity Provider Administrator
## HTTP request
v1.0 Driveitem Assignsensitivitylabel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/driveitem-assignsensitivitylabel.md
Namespace: microsoft.graph
Asynchronously assign a sensitivity label to a [driveItem][item-resource].
-This API is part of Microsoft SharePoint and OneDrive APIs that perform advanced premium administrative functions and is considered a protected API. Protected APIs require you to have additional validation, beyond permission and consent, before you can use them.
+This API is part of Microsoft SharePoint and OneDrive APIs that perform advanced premium administrative functions and is considered a protected API. Protected APIs require you to have additional validation, beyond permission and consent, before you can use them. Before you call this API with application permissions, you must [request access](https://aka.ms/PreviewSPOPremiumAPI).
For more information about sensitivity labels from an administrator's perspective, see [Enable sensitivity labels for Office files in SharePoint and OneDrive](/microsoft-365/compliance/sensitivity-labels-sharepoint-onedrive-files?view=o365-worldwide&preserve-view=true). > [!NOTE]
-> Before you call this API with application permissions, you must request access. To request access, fill out the [request form](https://aka.ms/PreviewSPOPremiumAPI).
+> This is a metered API and some charges for use may apply. For details, see [Overview of metered Microsoft 365 APIs in Microsoft Graph](/graph/metered-api-overview).
## 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).
v1.0 Driveitem Invite https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/driveitem-invite.md
In the request body, provide a JSON object with the following parameters.
| message | String | A plain text formatted message that is included in the sharing invitation. Maximum length 2000 characters. | | requireSignIn | Boolean | Specifies where the recipient of the invitation is required to sign-in to view the shared item. | | sendInvitation | Boolean | Specifies if an email or post is generated (false) or if the permission is just created (true). |
-| roles | Collection(String) | Specify the roles that are be granted to the recipients of the sharing invitation. |
-| expirationDateTime | DateTimeOffset | Specify the DateTime after which the permission expires. Available on OneDrive for Business, SharePoint, and premium personal OneDrive accounts.
+| roles | Collection(String) | Specifies the roles that are be granted to the recipients of the sharing invitation. |
+| expirationDateTime | DateTimeOffset | Specifies the **dateTime** after which the permission expires. For OneDrive for Business and SharePoint, **xpirationDateTime** is only applicable for **sharingLink** permissions. Available on OneDrive for Business, SharePoint, and premium personal OneDrive accounts.
| password | String | The password set on the invite by the creator. Optional and OneDrive Personal only ## Example
v1.0 Dynamics Item Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/dynamics-item-get.md
Title: Get items
-description: Gets an item object in Dynamics 365 Business Central.
--
+ Title: "Get items"
+description: "Gets an item object in Dynamics 365 Business Central."
+
+documentationcenter: ""
+ ms.localizationpriority: medium ms.prod: "dynamics-365-business-central" doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-```
+```http
GET /financials/companies/{id}/items/{id} ``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers |Header |Value |
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and an **items** object in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [item](../resources/dynamics-item.md) objects in the response body.
## Example
-**Request**
-Here is an example of the request.
+### Request
+
+The following is an example of the request.
```http GET https://graph.microsoft.com/beta/financials/companies/{id}/items/{id} ```
-**Response**
+### Response
-Here is an example of the response.
+The following is an example of the response.
> **Note**: The response object shown here might be shortened for readability.
Here is an example of the response.
"taxGroupCode": "FURNITURE", "lastModifiedDateTime": "2017-03-07T00:35:30.073Z" }- ```---
v1.0 Dynamics Paymentterms Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/dynamics-paymentterms-get.md
Title: Get paymentTerms
-description: Gets a payment term object in Dynamics 365 Business Central.
--
+ Title: "Get paymentTerms"
+description: "Retrieve the properties and relationships of a paymentTerms object for Dynamics 365 Business Central."
+
+documentationcenter: ""
+ ms.localizationpriority: medium ms.prod: "dynamics-365-business-central" doc_type: apiPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the properties and relationships of a payment terms object for Dynamics 365 Business Central.
+Retrieve the properties and relationships of a [paymentTerms](../resources/dynamics-paymentterms.md) object for Dynamics 365 Business Central.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
GET /financials/companies/{id}/paymentTerms/{id}
``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers |Header |Value |
Do not supply a request body for this method.
## Response If successful, this method returns a `200 OK` response code and a **paymentTerms** object in the response body.
-## Example
+## Examples
-**Request**
+### Request
-Here is an example of the request.
+The following is an example of the request.
```http GET https://graph.microsoft.com/beta/financials/companies/{id}/paymentTerms/{id} ```
-**Response**
+### Response
-Here is an example of the response.
+The following is an example of the response.
> **Note**: The response object shown here might be shortened for readability.
v1.0 Ediscovery Casesettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/ediscovery-casesettings-get.md
GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/5b840b94-f821-4
[!INCLUDE [sample-code](../includes/snippets/php/get-case-settings-for-caseid-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Ediscovery Casesettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/ediscovery-casesettings-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-settings-for-caseid-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Ediscovery Custodian Post Unifiedgroupsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/ediscovery-custodian-post-unifiedgroupsources.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-unifiedgroupsource-from-email-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-unifiedgroupsource-from-id-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
v1.0 Ediscovery Legalhold Post Sitesources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/ediscovery-legalhold-post-sitesources.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-sitesource-from--2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Ediscovery Legalhold Post Usersources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/ediscovery-legalhold-post-usersources.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-usersource-from--2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Ediscovery Sourcecollection Post Additionalsources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/ediscovery-sourcecollection-post-additionalsources.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-datasource-caseid-sourcecollectionid-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/add-site-to-additional-sources-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
v1.0 Educationassignment Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-delta.md
GET https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f
-- #### Response The following is an example of the response.
GET /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/delta?$s
--- #### Response The following is an example of the response.
GET /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/delta?$d
-- #### Response The following is an example of the response.
v1.0 Educationassignment List Submissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-list-submissions.md
The following is an example of the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "sampleKeys": ["72a7baec-c3e9-4213-a850-f62de0adad5f","efcdf80b-a5de-42ac-8579-e40b0223d48b"],
+ "sampleKeys": ["2003c52e-807a-4186-9b49-60c573095461","2be08d97-b140-4eec-8cbd-88238d571060"],
"name": "get_submissions_expand" }--> ```msgraph-interactive
Prefer: include-unknown-enum-members
--- #### Response The following is an example of the response.
v1.0 Educationassignment Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-setupresourcesfolder.md
Content-type: application/json
- ### Response The following is an example of the response.
v1.0 Educationcategory Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationcategory-delta.md
GET https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f
-- #### Response The following is an example of the response.
GET /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignmentcategories
-- #### Response The following is an example of the response.
GET /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignmentcategories
[!INCLUDE [sample-code](../includes/snippets/php/get-classcategories-delta-for-token-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -
v1.0 Educationsubmission Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-get.md
Prefer: include-unknown-enum-members
-- #### Response The following is an example of the response.
v1.0 Educationsubmission Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-setupresourcesfolder.md
Content-type: application/json
-- #### Response The following is an example of the response.
v1.0 Employeeexperience List Learningproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/employeeexperience-list-learningproviders.md
Content-type: application/json
"longLogoWebUrlForDarkTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "squareLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "longLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png",
- "isEnabled": true,
"loginWebUrl": "https://www.linkedin.com/learning-login/teams" }, {
Content-type: application/json
"longLogoWebUrlForDarkTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "squareLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "longLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png",
- "isEnabled": true,
"loginWebUrl": "https://www.linkedin.com/learning-login/teams" } ]
v1.0 Employeeexperience Post Learningproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/employeeexperience-post-learningproviders.md
You can specify the following properties when you create a **learningProvider**.
|Property|Type|Description| |:|:|:| |displayName|String|The display name that appears in Viva Learning. Required.|
-|isEnabled|Boolean|The state of the provider. Optional.|
|loginWebUrl|String|Authentication URL to access the courses for the provider. Optional.| |longLogoWebUrlForDarkTheme|String|The long logo URL for the dark mode, which needs to be a publicly accessible image. This image would be saved to the Blob storage of Viva Learning for rendering within the Viva Learning app. Required.| |longLogoWebUrlForLightTheme|String|The long logo URL for the light mode, which needs to be a publicly accessible image. This image would be saved to the Blob storage of Viva Learning for rendering within the Viva Learning app. Required.|
Content-Type: application/json
"longLogoWebUrlForDarkTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "squareLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "longLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png",
- "isEnabled": true,
"loginWebUrl": "https://www.linkedin.com/learning-login/teams" } ```
Content-type: application/json
"longLogoWebUrlForDarkTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "squareLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "longLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png",
- "isEnabled": true,
"loginWebUrl": "https://www.linkedin.com/learning-login/teams" } ```
v1.0 Entitlementmanagement Post Accesspackageassignmentpolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/entitlementmanagement-post-accesspackageassignmentpolicies.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-accesspackageassignmentpolicy-from-accesspackageassignmentpolicies-questions-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] ---- #### Response
v1.0 Event Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/event-delta.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.Read, Calendars.ReadWrite |
-|Delegated (personal Microsoft account) | Calendars.Read, Calendars.ReadWrite |
-|Application | Calendars.Read, Calendars.ReadWrite |
+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
+|Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
+|Application | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
## HTTP request
v1.0 Event Forward https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/event-forward.md
Content-type: application/json
{ "ToRecipients":[ {
- "emailAddress": {
- "address":"danas@contoso.onmicrosoft.com",
- "name":"Dana Swope"
+ "EmailAddress": {
+ "Address":"danas@contoso.onmicrosoft.com",
+ "Name":"Dana Swope"
} } ],
v1.0 Event Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/event-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.Read |
-|Delegated (personal Microsoft account) | Calendars.Read |
-|Application | Calendars.Read |
+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read |
+|Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read |
+|Application | Calendars.ReadBasic, Calendars.Read |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Event List Instances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/event-list-instances.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.Read |
-|Delegated (personal Microsoft account) | Calendars.Read |
-|Application | Calendars.Read |
+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read |
+|Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read |
+|Application | Calendars.ReadBasic, Calendars.Read |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Group Delete Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-delete-owners.md
Namespace: microsoft.graph
Use this API to remove an owner from a Microsoft 365 group or a security group through the **owners** navigation property. When owners are assigned to a group, the last owner (a user object) of the group cannot be removed.
-> **Note:** For issues encountered when removing owner of a group associated with a [team](/graph/api/resources/team.md), see [Known Issues](/graph/known-issues#removing-a-group-owner-also-removes-the-user-as-a-group-member).
+> **Note:** For issues encountered when removing owner of a group associated with a [team](/graph/api/resources/team), see [Known Issues](/graph/known-issues#removing-a-group-owner-also-removes-the-user-as-a-group-member).
## Permissions
v1.0 Group List Permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list-permissiongrants.md
GET https://graph.microsoft.com/beta/groups/14c981a4-dca9-4565-bae6-e13ada8861be
[!INCLUDE [sample-code](../includes/snippets/php/group-list-permission-grants-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Identitygovernance Workflowversion Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflowversion-get.md
The following is an example of a request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "lifecycleworkflows_get_workflowversion_select"
+ "name": "lifecycleworkflows_get_workflowversion_select",
+ "sampleKeys": ["15239232-66ed-445b-8292-2f5bbb2eb833", "2"]
} --> ``` http
v1.0 Internaldomainfederation Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internaldomainfederation-delete.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported| |Application|Domain.ReadWrite.All|
-The calling user must be assigned the Global Administrator [Azure AD role](/azure/active-directory/roles/permissions-reference).
+The calling user must be assigned one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+- Security Administrator
+- External Identity Provider Administrator
## HTTP request
v1.0 Internaldomainfederation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internaldomainfederation-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported| |Application|Domain.Read.All, Domain.ReadWrite.All|
-The calling user must be assigned the Global Administrator [Azure AD role](/azure/active-directory/roles/permissions-reference).
+The calling user must be assigned one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+- Security Administrator
+- External Identity Provider Administrator
## HTTP request
v1.0 Internaldomainfederation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internaldomainfederation-update.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported| |Application|Domain.ReadWrite.All|
-The calling user must be assigned the Global Administrator [Azure AD role](/azure/active-directory/roles/permissions-reference).
+The calling user must be assigned one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+- Security Administrator
+- External Identity Provider Administrator
## HTTP request
v1.0 Intune Enrollment Depenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. [See here](/mem/intune/enrollment/windows-enrollment-methods) for additional information.|
|supportDepartment|String|Support department information| |passCodeDisabled|Boolean|Indicates if Passcode setup pane is disabled| |isMandatory|Boolean|Indicates if the profile is mandatory|
v1.0 Intune Enrollment Depenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. [See here](/mem/intune/enrollment/windows-enrollment-methods) for additional information.|
|supportDepartment|String|Support department information| |passCodeDisabled|Boolean|Indicates if Passcode setup pane is disabled| |isMandatory|Boolean|Indicates if the profile is mandatory|
v1.0 Intune Enrollment Depiosenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depiosenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. [See more](/mem/intune/enrollment/windows-enrollment-methods) for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
The following table shows the properties that are required when you create the d
|userSessionTimeoutInSeconds|Int32|Indicates timeout of temporary session| |passcodeLockGracePeriodInSeconds|Int32|Indicates timeout before locked screen requires the user to enter the device passocde to unlock it| |carrierActivationUrl|String|Carrier URL for activating device eSIM.|
-|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
+|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. [See here](/mem/intune/enrollment/device-enrollment-shared-ios)|
v1.0 Intune Enrollment Depiosenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depiosenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. [See here](/mem/intune/enrollment/windows-enrollment-methods) for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
The following table shows the properties that are required when you create the [
|userSessionTimeoutInSeconds|Int32|Indicates timeout of temporary session| |passcodeLockGracePeriodInSeconds|Int32|Indicates timeout before locked screen requires the user to enter the device passocde to unlock it| |carrierActivationUrl|String|Carrier URL for activating device eSIM.|
-|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
+|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. [See here](/mem/intune/enrollment/device-enrollment-shared-ios)|
v1.0 Intune Enrollment Depmacosenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depmacosenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. [See here](/mem/intune/enrollment/windows-enrollment-methods) for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
v1.0 Intune Enrollment Depmacosenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depmacosenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. [See here](/mem/intune/enrollment/windows-enrollment-methods) for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
v1.0 Intune Enrollment Importedappledeviceidentity Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-importedappledeviceidentity-create.md
The following table shows the properties that are required when you create the i
|serialNumber|String|Device serial number| |requestedEnrollmentProfileId|String|Enrollment profile Id admin intends to apply to the device during next enrollment| |requestedEnrollmentProfileAssignmentDateTime|DateTimeOffset|The time enrollment profile was assigned to the device|
-|isSupervised|Boolean|Indicates if the Apple device is supervised. More information is at: https://support.apple.com/en-us/HT202837|
+|isSupervised|Boolean|Indicates if the Apple device is supervised. More information is at: https://support.apple.com/en-us/HT202837 |
|discoverySource|[discoverySource](../resources/intune-enrollment-discoverysource.md)|Apple device discovery source. Possible values are: `unknown`, `adminImport`, `deviceEnrollmentProgram`.| |isDeleted|Boolean|Indicates if the device is deleted from Apple Business Manager| |createdDateTime|DateTimeOffset|Created Date Time of the device|
v1.0 Intune Enrollment Importedappledeviceidentity Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-importedappledeviceidentity-update.md
The following table shows the properties that are required when you create the [
|serialNumber|String|Device serial number| |requestedEnrollmentProfileId|String|Enrollment profile Id admin intends to apply to the device during next enrollment| |requestedEnrollmentProfileAssignmentDateTime|DateTimeOffset|The time enrollment profile was assigned to the device|
-|isSupervised|Boolean|Indicates if the Apple device is supervised. More information is at: https://support.apple.com/en-us/HT202837|
+|isSupervised|Boolean|Indicates if the Apple device is supervised. More information is at: https://support.apple.com/en-us/HT202837 |
|discoverySource|[discoverySource](../resources/intune-enrollment-discoverysource.md)|Apple device discovery source. Possible values are: `unknown`, `adminImport`, `deviceEnrollmentProgram`.| |isDeleted|Boolean|Indicates if the device is deleted from Apple Business Manager| |createdDateTime|DateTimeOffset|Created Date Time of the device|
v1.0 Intune Shared Deviceappmanagement Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-deviceappmanagement-get.md
GET /deviceAppManagement
## Optional query parameters
-This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response.
+This method supports the [OData Query Parameters](../../v1.0/api/user-delta.md#odata-query-parameters) to help customize the response.
## Request headers
v1.0 Intune Shared Deviceappmanagement Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-deviceappmanagement-update.md
The following table shows the properties that are required when you create the [
|id|String|Key of the entity.| |**On-boarding**| |isEnabledForMicrosoftStoreForBusiness|Boolean|Whether the account is enabled for syncing applications from the Microsoft Store for Business.|
-|microsoftStoreForBusinessLanguage|String|The locale information used to sync applications from the Microsoft Store for Business. Cultures that are specific to a country/region. The names of these cultures follow RFC 4646 (Windows Vista and later). The format is <languagecode2>-<country/regioncode2>, where <languagecode2> is a lowercase two-letter code derived from ISO 639-1 and <country/regioncode2> is an uppercase two-letter code derived from ISO 3166. For example, en-US for English (United States) is a specific culture.|
+|microsoftStoreForBusinessLanguage|String|The locale information used to sync applications from the Microsoft Store for Business. Cultures that are specific to a country/region. The names of these cultures follow RFC 4646 (Windows Vista and later). The format is &lt;languagecode2&gt;-<country/regioncode2>, where &lt;languagecode2&gt; is a lowercase two-letter code derived from ISO 639-1 and <country/regioncode2> is an uppercase two-letter code derived from ISO 3166. For example, en-US for English (United States) is a specific culture.|
|microsoftStoreForBusinessLastCompletedApplicationSyncTime|DateTimeOffset|The last time an application sync from the Microsoft Store for Business was completed.| |microsoftStoreForBusinessLastSuccessfulSyncDateTime|DateTimeOffset|The last time the apps from the Microsoft Store for Business were synced successfully for the account.| |microsoftStoreForBusinessPortalSelection|[microsoftStoreForBusinessPortalSelectionOptions](../resources/intune-onboarding-microsoftstoreforbusinessportalselectionoptions.md)|The end user portal information is used to sync applications from the Microsoft Store for Business to Intune Company Portal. There are three options to pick from \['Company portal only', 'Company portal and private store', 'Private store only'\]. Possible values are: `none`, `companyPortal`, `privateStore`.|
-This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response.
+This method supports the [OData Query Parameters](../../v1.0/api/user-delta.md#odata-query-parameters) to help customize the response.
## Response If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body.
v1.0 Intune Shared Devicecategory Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicecategory-get.md
GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceR
## Optional query parameters
-This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response.
+This method supports the [OData Query Parameters](../../v1.0/api/user-delta.md#odata-query-parameters) to help customize the response.
## Request headers
v1.0 Intune Shared Devicemanagement Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicemanagement-get.md
GET /deviceManagement
## Optional query parameters
-This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response.
+This method supports the [OData Query Parameters](../../v1.0/api/user-delta.md#odata-query-parameters) to help customize the response.
## Request headers |Header|Value|
v1.0 Intune Shared Devicemanagementderivedcredentialsettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicemanagementderivedcredentialsettings-update.md
The following table shows the properties that are required when you create the [
|**RA Policy**| |helpUrl|String|The URL that will be accessible to end users as they retrieve a derived credential using the Company Portal.| |displayName|String|The display name for the profile.|
-|issuer|[deviceManagementDerivedCredentialIssuer](../resources/intune-shared-devicemanagementderivedcredentialissuer.md)|The derived credential provider to use. Possible values are: `intercede`, `entrustDatacard`, `purebred`.|
-|notificationType|[deviceManagementDerivedCredentialNotificationType](../resources/intune-shared-devicemanagementderivedcredentialnotificationtype.md)|The methods used to inform the end user to open Company Portal to deliver Wi-Fi, VPN, or email profiles that use certificates to the device. Possible values are: `none`, `companyPortal`, `email`.|
+|issuer|[deviceManagementDerivedCredentialIssuer](/graph/api/resources/intune-rapolicy-devicemanagementderivedcredentialissuer)|The derived credential provider to use. Possible values are: `intercede`, `entrustDatacard`, `purebred`.|
+|notificationType|[deviceManagementDerivedCredentialNotificationType](/graph/api/resources/intune-rapolicy-devicemanagementderivedcredentialnotificationtype)|The methods used to inform the end user to open Company Portal to deliver Wi-Fi, VPN, or email profiles that use certificates to the device. Possible values are: `none`, `companyPortal`, `email`.|
## Response
v1.0 Intune Shared Reportroot Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-reportroot-get.md
GET /reports
``` ## Optional query parameters
-This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response.
+This method supports the [OData Query Parameters](../../v1.0/api/user-delta.md#odata-query-parameters) to help customize the response.
## Request headers |Header|Value| |:|:|
v1.0 Intune Shared User Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-user-get.md
GET /users/{usersId}
## Optional query parameters
-This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response.
+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
## Request headers
v1.0 Intune Shared Windowsdomainjoinconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-windowsdomainjoinconfiguration-get.md
GET /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDeviceId
## Optional query parameters
-This method supports the [OData Query Parameters](https://developer.microsoft.com/graph/docs/concepts/query_parameters) to help customize the response.
+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
## Request headers
v1.0 Intune Shared Windowsupdatestate Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-windowsupdatestate-create.md
The following table shows the properties that are required when you create the w
|userId|String|The id of the user.| |deviceDisplayName|String|Device display name.| |userPrincipalName|String|User principal name.|
-|status|[windowsUpdateStatus](../resources/intune-shared-windowsupdatestatus.md)|Windows udpate status. Possible values are: `upToDate`, `pendingInstallation`, `pendingReboot`, `failed`.|
+|status|[windowsUpdateStatus](/graph/api/intune-shared-windowsupdatestate-update)|Windows udpate status. Possible values are: `upToDate`, `pendingInstallation`, `pendingReboot`, `failed`.|
|qualityUpdateVersion|String|The Quality Update Version of the device.| |featureUpdateVersion|String|The current feature update version of the device.| |lastScanDateTime|DateTimeOffset|The date time that the Windows Update Agent did a successful scan.|
v1.0 Intune Shared Windowsupdatestate Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-windowsupdatestate-update.md
The following table shows the properties that are required when you create the [
|userId|String|The id of the user.| |deviceDisplayName|String|Device display name.| |userPrincipalName|String|User principal name.|
-|status|[windowsUpdateStatus](../resources/intune-shared-windowsupdatestatus.md)|Windows udpate status. Possible values are: `upToDate`, `pendingInstallation`, `pendingReboot`, `failed`.|
+|status|[windowsUpdateStatus](/graph/api/intune-shared-windowsupdatestate-update)|Windows udpate status. Possible values are: `upToDate`, `pendingInstallation`, `pendingReboot`, `failed`.|
|qualityUpdateVersion|String|The Quality Update Version of the device.| |featureUpdateVersion|String|The current feature update version of the device.| |lastScanDateTime|DateTimeOffset|The date time that the Windows Update Agent did a successful scan.|
v1.0 Learningprovider Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/learningprovider-get.md
Content-type: application/json
"longLogoWebUrlForDarkTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "squareLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "longLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png",
- "isEnabled": true,
"loginWebUrl": "https://www.linkedin.com/learning-login/teams" } ```
v1.0 Learningprovider Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/learningprovider-update.md
PATCH /employeeExperience/learningProviders/{learningProviderId}
|Property|Type|Description| |:|:|:| |displayName|String|The display name that appears in Viva Learning. Required.|
-|isEnabled|Boolean|The state of the provider. Optional.|
|loginWebUrl|String|Authentication URL to access the courses for the provider. Optional.| |longLogoWebUrlForDarkTheme|String|The long logo URL for the dark mode, which needs to be a publicly accessible image. This image would be saved to the Blob storage of Viva Learning for rendering within the Viva Learning app. Required.| |longLogoWebUrlForLightTheme|String|The long logo URL for the light mode, which needs to be a publicly accessible image. This image would be saved to the Blob storage of Viva Learning for rendering within the Viva Learning app. Required.|
Content-Type: application/json
"longLogoWebUrlForDarkTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "squareLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png", "longLogoWebUrlForLightTheme": "https://support.content.office.net/en-us/media/4c531d12-4c13-4782-a6e4-4b8f991801a3.png",
- "isEnabled": false,
"loginWebUrl": "https://www.linkedin.com/learning-login/teams" } ```
v1.0 List Post Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/list-post-columns.md
Create a column for a [list][list] with a request that specifies a [columnDefini
## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/concepts/permissions_reference.md).
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Onlinemeeting List Transcripts https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/onlinemeeting-list-transcripts.md
Namespace: microsoft.graph
Retrieve the list of [callTranscript](../resources/calltranscript.md) objects associated with an [onlineMeeting](../resources/onlinemeeting.md).
-> **Note:** In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
+> **Notes:**
+> - In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
+> - This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
## Permissions
One of the following permissions is required to call this API. To learn more, in
To use application permission for this API, tenant administrators must create an application access policy and grant it to a user. This authorizes the app configured in the policy to fetch online meetings and/or online meeting artifacts on behalf of that user (with the user ID specified in the request path). For more details, see [Allow applications to access online meetings on behalf of a user](/graph/cloud-communication-online-meeting-application-access-policy). > [!NOTE]
-> This API would work for a meeting only if the meeting has not expired. For more details, see [Limits and specifications for Microsoft Teams](/microsoftteams/limits-specifications-teams#meeting-expiration).
+> This API works for a meeting only if the meeting has not expired. For more details, see [Limits and specifications for Microsoft Teams](/microsoftteams/limits-specifications-teams#meeting-expiration).
## HTTP request
v1.0 Onpremisesdirectorysynchronization Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/onpremisesdirectorysynchronization-get.md
One of the following permissions is required to call this API. To learn more, in
| Delegated (personal Microsoft account) | Not supported. | | Application | Not supported. |
-For delegated scenarios, the user needs to be assigned the *Global administrator* [role](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
+For delegated scenarios, the user needs to be assigned the *Global Administrator* [role](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
## HTTP request
v1.0 Onpremisesdirectorysynchronization Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/onpremisesdirectorysynchronization-update.md
One of the following permissions is required to call this API. To learn more, in
| Delegated (personal Microsoft account) | Not supported. | | Application | Not supported. |
-For delegated scenarios, the user needs to be assigned the *Global administrator* [role](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
+For delegated scenarios, the user needs to be assigned the *Global Administrator* [role](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
## HTTP request
v1.0 Organization Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organization-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Organization.Read.All, Directory.Read.All, Organization.ReadWrite.All, Directory.ReadWrite.All |
+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+* Global Administrator
+* User Administrator
+* User
+* Helpdesk Administrator
+* Service Support Administrator
+* Billing Administrator
+* Mailbox Administrator
+* Partner Tier1 Support
+* Partner Tier2 Support
+* Directory Readers
+* Directory Writers
+* AdHoc License Administrator
+* Application Administrator
+* Security Reader
+* Security Administrator
+* Privileged Role Administrator
+* Cloud Application Administrator
+* Customer LockBox Access Approver
+* Dynamics 365 Administrator
+* Power BI Administrator
+* Azure Information Protection Administrator
+* Customer LockBox Access Approver
+* Dynamics 365 Administrator
+* Power BI Administrator
+* Azure Information Protection Administrator
+* Desktop Analytics Administrator
+* License Administrator
+* Microsoft Managed Desktop Administrator
+* Authentication Administrator
+* Privileged Authentication Administrator
+* Teams Communications Administrator
+* Teams Communications Support Engineer
+* Teams Communications Support Specialist
+* Teams Administrator
+* Insights Administrator
+* Compliance Data Administrator
+* Security Operator
+* Kaizala Administrator
+* Global Reader
+* Volume Licensing Business Center User
+* Volume Licensing Service Center User
+* Modern Commerce User
+* Microsoft Store for Business User
+* Directory Reviewer
+* Guest User
+* Restricted Guest User
+ > **Note**: Applications granted the User.Read permission are able to read only the **id**, **displayName**, and **verifiedDomains** properties of the organization. All other properties will return with `null` values. To read all properties, use Organization.Read.All. ## HTTP request
v1.0 Organization Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organization-update.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Organization.ReadWrite.All |
+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+* Global Administrator
+* Partner Tier2 Support
+* Billing Administrator
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Organizationsettings List Pronounssettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organizationsettings-list-pronounssettings.md
+
+ Title: "List pronounsSettings"
+description: "Read the properties and relationships of a pronounsSettings object."
+
+ms.localizationpriority: medium
++
+# List pronounsSettings
+Namespace: microsoft.graph
++
+Get the properties of the [pronounsSettings](../resources/pronounssettings.md) resource for an organization.
+
+For more information on settings to manage pronouns support, see [Manage pronouns settings for an organization using the Microsoft Graph API](/graph/pronouns-configure-pronouns-availability).
+
+## 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) | Organization.Read.All, Organization.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+>**Note:** Using delegated permissions for this operation requires the signed-in user to have a global administrator role.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /organization/{organizationId}/settings/pronouns
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [pronounsSettings](../resources/pronounssettings.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "get_pronounssettings"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/organization/{organizationId}/settings/pronouns
+```
++
+### Response
+The following is an example of the response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.pronounsSettings"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "isEnabledInOrganization": true
+}
+```
+
v1.0 Participant Startholdmusic https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/participant-startholdmusic.md
Content-type: application/json
---- ### Response > **Note:** The response object shown here might be shortened for readability.
v1.0 Participant Stopholdmusic https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/participant-stopholdmusic.md
Content-type: application/json
---- ### Response > **Note:** The response object shown here might be shortened for readability.
v1.0 Plannerroster Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannerroster-post-members.md
The following table shows the properties that are required when you create the [
|Property|Type|Description| |:|:|:|
-|userId|String|Identifier of the .|
+|userId|String|Identifier of the user.|
|tenantId|String|Identifier of the tenant the user belongs to. Optional. Currently roster members cannot be from different tenants.| |roles|String collection|Additional roles assigned to the user. Optional. Currently there are no additional roles available for users.|
v1.0 Presence Setstatusmessage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/presence-setstatusmessage.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/setstatusmessage-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/setstatusmessage-another-user-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Set status message: response
GET https://graph.microsoft.com/beta/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/
-- #### Get another user presence: response Since this presence request does not qualify as a [self presence](presence-get.md#example-1-get-your-own-presence-information) request, `statusMessage.expiryDateTime` and `statusMessage.publishedDateTime` properties are not included in the response body.
v1.0 Print Delete Taskdefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/print-delete-taskdefinition.md
DELETE https://graph.microsoft.com/beta/print/taskDefinitions/4c6a0f26-8e5d-4bf6
[!INCLUDE [sample-code](../includes/snippets/php/delete-taskdefinition-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Print List Taskdefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/print-list-taskdefinitions.md
GET https://graph.microsoft.com/beta/print/taskDefinitions
[!INCLUDE [sample-code](../includes/snippets/php/print-list-taskdefinitions-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Print Post Shares https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/print-post-shares.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-printershare-from-print-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Print Post Taskdefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/print-post-taskdefinitions.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/print-create-taskdefinition-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Print Update Taskdefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/print-update-taskdefinition.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/print-update-taskdefinition-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Printconnector Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printconnector-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-connector-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Printer Delete Tasktrigger https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printer-delete-tasktrigger.md
DELETE https://graph.microsoft.com/beta/print/printers/1a5f91a7-9bd1-4d5f-bb86-f
[!INCLUDE [sample-code](../includes/snippets/php/delete-printer-tasktrigger-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Printer Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printer-delete.md
Title: "Delete printer"
-description: "Delete (unregister) a printer".
+description: "Delete (unregister) a printer"
ms.localizationpriority: medium ms.prod: "cloud-printing"
v1.0 Printer List Jobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printer-list-jobs.md
GET https://graph.microsoft.com/beta/print/printers/{id}/jobs
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Printer List Tasktriggers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printer-list-tasktriggers.md
GET https://graph.microsoft.com/beta/print/printers/{id}/taskTriggers
[!INCLUDE [sample-code](../includes/snippets/php/get-printer-tasktriggers-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Printer Post Jobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printer-post-jobs.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Printer Post Tasktriggers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printer-post-tasktriggers.md
POST https://graph.microsoft.com/beta/print/printers/ae63f617-4856-4b45-8ea9-69d
[!INCLUDE [sample-code](../includes/snippets/php/create-printer-tasktrigger-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Printer Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printer-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-printer-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Printershare List Jobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printershare-list-jobs.md
GET https://graph.microsoft.com/beta/print/shares/{id}/jobs
-- ### Response The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
v1.0 Printershare Post Jobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printershare-post-jobs.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Printtask Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printtask-get.md
GET https://graph.microsoft.com/beta/print/taskDefinitions/3203656e-6069-4e10-81
[!INCLUDE [sample-code](../includes/snippets/php/get-task-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Printtaskdefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printtaskdefinition-get.md
GET https://graph.microsoft.com/beta/print/taskDefinitions/fab143fd-ee61-4358-85
[!INCLUDE [sample-code](../includes/snippets/php/get-taskdefinition-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Printtaskdefinition List Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printtaskdefinition-list-tasks.md
GET https://graph.microsoft.com/beta/print/taskDefinitions/92d72a3d-cad7-4809-89
[!INCLUDE [sample-code](../includes/snippets/php/get-printtaskdefinition-tasks-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Printtaskdefinition Update Task https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printtaskdefinition-update-task.md
PATCH https://graph.microsoft.com/beta/print/taskDefinitions/3203656e-6069-4e10-
[!INCLUDE [sample-code](../includes/snippets/php/update-task-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Printtasktrigger Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/printtasktrigger-get.md
GET https://graph.microsoft.com/beta/print/printers/{printerId}/taskTriggers/{ta
[!INCLUDE [sample-code](../includes/snippets/php/get-printer-tasktrigger-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Pronounssettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/pronounssettings-update.md
+
+ Title: "Update pronounsSettings"
+description: "Update the properties of a pronounsSettings object."
+
+ms.localizationpriority: medium
++
+# Update pronounsSettings
+
+Namespace: microsoft.graph
++
+Update the properties of a [pronounsSettings](../resources/pronounssettings.md) in an organization.
+
+For more information on settings to manage pronouns support, see [Manage pronouns settings for an organization using the Microsoft Graph API](/graph/pronouns-configure-pronouns-availability).
+
+## 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) | Organization.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+>**Note:** Using delegated permissions for this operation requires the signed-in user to have a global administrator role.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /organization/{organizationId}/settings/pronouns
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply *only* the values for properties that should be updated. Existing properties that are not included in the request body will maintain their previous values.
+
+The following table specifies the properties that can be updated.
+
+|Property|Type|Description|
+|:|:|:|
+|isEnabledInOrganization|Boolean|`true` to enable pronouns in the organization, `false` otherwise. The default is `false`, and pronouns are disabled. Required.|
+++
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [pronounsSettings](../resources/pronounssettings.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "update_pronounssettings"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/organization/{organizationId}/settings/pronouns
+Content-Type: application/json
+
+{
+ "isEnabledInOrganization": true
+}
+```
++
+### Response
+The following is an example of the response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.pronounsSettings",
+ "name": "update_pronounssettings"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "isEnabledInOrganization": true
+}
+```
+
v1.0 Range Unmerge https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/range-unmerge.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Unmerge the range cells into separate cells.+ ## 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).
POST /me/drive/items/{id}/workbook/worksheets/{id|name}/range(address='<address>
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/range(address='<address>')/unmerge POST /me/drive/items/{id}/workbook/tables/{id|name}/columns/{id|name}/range/unmerge POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/range/unmerge- ```+ ## Request headers | Name | Description| |:|:-|
POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/ra
## Response
-If successful, this method returns `200 OK` response code. It does not return anything in the response body.
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
## Example
-Here is an example of how to call this API.
-##### Request
-Here is an example of the request.
+
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
POST https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/
-##### Response
-Here is an example of the response.
+### Response
+The following is an example of the response.
<!-- { "blockType": "response" } --> ```http
-HTTP/1.1 200 OK
+HTTP/1.1 204 No Content
``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Rangeformat Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rangeformat-update.md
The following examples demonstrate how to update properties of the [workbookRang
The result of this set of requests is a table with three cells formatted like the top three cells in the image below.
-![Excel chart table with three cells whose format, fill, and font properties have been updated.](/graph/concepts/images/ExcelRangeFormatting.png)
+<!--![Excel chart table with three cells whose format, fill, and font properties have been updated.](/images/ExcelRangeFormatting.png)-->
##### Request This request updates the vertical alignment, row height, and column height of the first cell.
v1.0 Rbacapplication List Transitiveroleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-list-transitiveroleassignments.md
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and a collection of [unifiedRoleAssignment](../resources/unifiedroleassignment.md) objects in the response body.
+If your request doesn't include the **ConsistencyLevel** header set to `eventual`, this method returns `404 Not Found` response code.
+ ## Examples For the examples in this section, consider the following role assignment scenario. A user named Alice has both direct and transitive role assignments as follows:
ConsistencyLevel: eventual
--- #### Response The following is an example of the response.
ConsistencyLevel: eventual
--- #### Response The following is an example of the response.
v1.0 Schedule Post Shifts https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/schedule-post-shifts.md
Namespace: microsoft.graph
Create a new [shift](../resources/shift.md) instance in a [schedule](../resources/schedule.md).
+The duration of a shift cannot be less than 1 minute or longer than 24 hours.
+ ## 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).
v1.0 Security Ediscoveryreviewset Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewset-get.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /ediscoveryExportOperation/reviewSet
+GET /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets/{reviewSetId}
``` ## Optional query parameters
v1.0 Serviceprincipal Post Serviceprincipals https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-post-serviceprincipals.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All |
-> [!IMPORTANT]
-> The following additional requirements must be met for an app to create a service principal:
-> + If the backing application is registered in the calling app's home tenant, the calling app must be the owner of the backing application.
-> + If the backing application is registered in another Azure AD tenant, the calling app must be assigned the `Cloud Application Administrator` or `Application Administrator` role.
+For multi-tenant apps, the calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+++ Global Administrator++ Application Administrator++ Cloud Application Administrator roles+
+For single-tenant apps where the calling user is a non-admin user but is the owner of the backing application, the user must have the *Application Developer* role.
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Serviceprincipal Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-update.md
The following example shows how to assign a custom security attribute with a str
To assign custom security attributes, the calling principal must be assigned the Attribute Assignment Administrator role and must be granted the *CustomSecAttributeAssignment.ReadWrite.All* permission.
-For other similar examples for users, see [Assign, update, or remove custom security attributes using the Microsoft Graph API](/graph/custom-security-attributes-examples).
+For other similar examples for users, see [Examples: Assign, update, list, or remove custom security attribute assignments using the Microsoft Graph API](/graph/custom-security-attributes-examples).
#### Request
v1.0 Shift Put https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/shift-put.md
Replace an existing [shift](../resources/shift.md).
If the specified [shift](../resources/shift.md) doesn't exist, this method returns `404 Not found`.
+The duration of a shift cannot be less than 1 minute or longer than 24 hours.
+ ## 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).
v1.0 Synchronization Synchronization Acquireaccesstoken https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronization-acquireaccesstoken.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Directory.ReadWrite.All|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|Application.ReadWrite.OwnedBy, Directory.ReadWrite.All|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP request
v1.0 Synchronization Synchronization Secrets https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronization-secrets.md
Provide credentials for establishing connectivity with the target system.
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported. |
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationjob-delete.md
Stop the synchronization job, and permanently delete all the state associated wi
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported. |
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationjob-get.md
Retrieve the existing synchronization job and its properties.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) |Directory.Read.All |
-|Delegated (personal Microsoft account) |Not supported. |
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.Read.All, Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.Read.All, Synchronization.ReadWrite.All|
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationjob-list.md
List existing jobs for a given application instance (service principal).
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported. |
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.Read.All, Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.Read.All, Synchronization.ReadWrite.All|
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Pause https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationjob-pause.md
Temporarily stop a running synchronization job. All the progress, including job
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported. |
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationjob-post.md
Create new synchronization job with a default synchronization schema. The job is
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported.|
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Provision On Demand https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationjob-provision-on-demand.md
Select a user and provision the account on-demand. The rate limit for this API i
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported. |
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP request
v1.0 Synchronization Synchronizationjob Restart https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationjob-restart.md
Restart a stopped synchronization job, forcing it to reprocess all the objects i
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported. |
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP Request
v1.0 Synchronization Synchronizationjob Start https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationjob-start.md
Start an existing synchronization job. If the job is in a paused state, it will
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported. |
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Validatecredentials https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationjob-validatecredentials.md
Validate that the credentials are valid in the tenant.
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported. |
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationschema-delete.md
Deletes the customized schema and resets the schema to the default configuration
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported.|
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Filteroperators https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationschema-filteroperators.md
List all operators supported in the [scoping filters](../resources/synchronizati
## 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) |Directory.Read.All |
-|Delegated (personal Microsoft account) |Not supported.|
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Functions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationschema-functions.md
List all the functions currently supported in the [attributeMappingSource](../re
## 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) |Directory.Read.All |
-|Delegated (personal Microsoft account) |Not supported.|
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationschema-get.md
Retrieve the schema for a given synchronization job or template.
## 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) |Directory.Read.All |
-|Delegated (personal Microsoft account) |Not supported. |
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.Read.All, Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.Read.All, Synchronization.ReadWrite.All|
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Parseexpression https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationschema-parseexpression.md
For more information about expressions, see [Writing Expressions for Attribute M
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported.|
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationschema-update.md
Update the synchronization schema for a given job or template. This method fully
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported.|
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationtemplate-get.md
Retrieve a synchronization template by its identifier.
## 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) |Directory.Read.All |
-|Delegated (personal Microsoft account) |Not supported.|
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.Read.All, Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.Read.All, Synchronization.ReadWrite.All|
### HTTP Request
v1.0 Synchronization Synchronizationtemplate List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationtemplate-list.md
List the synchronization templates associated with a given application or servic
## 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) |Directory.Read.All |
-|Delegated (personal Microsoft account) |Not supported.|
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.Read.All, Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.Read.All, Synchronization.ReadWrite.All|
### HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationtemplate Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationtemplate-update.md
Update (override) the synchronization template associated with a given applicati
## 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) |Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) |Not supported.|
-|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Synchronization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Synchronization.ReadWrite.All|
### HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Team Get Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/team-get-installedapps.md
GET /teams/{id}/installedApps/{id}
[!INCLUDE [sample-code](../includes/snippets/php/get-installed-teams-apps-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
GET https://graph.microsoft.com/beta/teams/{id}/installedApps/{id}?$expand=teams
[!INCLUDE [sample-code](../includes/snippets/php/get-installed-teams-apps-expand-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
v1.0 Team List Permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/team-list-permissiongrants.md
GET https://graph.microsoft.com/beta/teams/14c981a4-dca9-4565-bae6-e13ada8861be/
[!INCLUDE [sample-code](../includes/snippets/php/team-list-permission-grants-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Team Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/team-sendactivitynotification.md
The following example shows the response.
``` http HTTP/1.1 204 No Content ```+
+## See also
+
+- [Activity feed notification C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/csharp)
+- [Activity feed notification Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/nodejs)
v1.0 Teams List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/teams-list.md
GET https://graph.microsoft.com/beta/teams
-- #### Response The following is an example of a response.
GET https://graph.microsoft.com/beta/teams?$filter=displayName eq 'A Contoso Tea
-- #### Response The following is an example of a response.
v1.0 Teamsappsettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/teamsappsettings-get.md
Content-Type: application/json
"value": { "@odata.type": "#microsoft.graph.teamsAppSettings", "id": "65bdf003-0c4c-4bca-b102-0821ab0d1364",
+ "allowUserRequestsForAppAccess": true,
"isChatResourceSpecificConsentEnabled": "true" } }
v1.0 Teamsappsettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/teamsappsettings-update.md
PATCH /teamwork/teamsAppSettings
|Property|Type|Description| |:|:|:|
+|allowUserRequestsForAppAccess|Boolean|Indicates whether Teams users are allowed to request admins access to certain Teams apps.|
|isChatResourceSpecificConsentEnabled|Boolean|Indicates whether resource-specific consent for chats/meetings has been enabled for the tenant. If true, Teams apps that are allowed in the tenant and require resource-specific permissions can be installed inside chats and meetings. If false, the installation of any Teams app that requires resource-specific permissions in a chat or a meeting will be blocked.| - ## Response If successful, this method returns a `204 No Content` response code.
If successful, this method returns a `204 No Content` response code.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "update_teamsappsettings"
+ "name": "update_teamsappsettings_1"
} --> ``` http
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
+#### Response
-# [JavaScript](#tab/javascript)
+<!-- {
+ "blockType": "response"
+} -->
-# [Java](#tab/java)
+```http
+HTTP/1.1 204 No Content
+```
-# [Go](#tab/go)
+### Example 2: Allow Teams users to request admins for access to certain Teams Apps.
-# [PowerShell](#tab/powershell)
+#### Request
-# [PHP](#tab/php)
-
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_teamsappsettings_2"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/teamwork/teamsAppSettings
+Content-Type: application/json
+{
+ "@odata.type": "#microsoft.graph.teamsAppSettings",
+ "allowUserRequestsForAppAccess": "true"
+}
+```
#### Response
v1.0 Teamtemplate List Definitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/teamtemplate-list-definitions.md
Title: "List definitions" description: "List the teamTemplateDefinition objects associated with a teamTemplate."-+ ms.localizationpriority: medium ms.prod: "teamwork" doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Team.Create|
+|Delegated (work or school account)|TeamTemplates.Read|
|Delegated (personal Microsoft account)|Not supported|
-|Application|Team.Create|
+|Application|TeamTemplates.Read.All
## HTTP request
v1.0 Teamtemplatedefinition Get Teamdefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/teamtemplatedefinition-get-teamdefinition.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Team.Create|
+|Delegated (work or school account)|TeamTemplates.Read|
|Delegated (personal Microsoft account)|Not supported|
-|Application|Team.Create|
+|Application|TeamTemplates.Read.All
## HTTP request
v1.0 Teamtemplatedefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/teamtemplatedefinition-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Team.Create|
+|Delegated (work or school account)|TeamTemplates.Read|
|Delegated (personal Microsoft account)|Not supported|
-|Application|Team.Create|
+|Application|TeamTemplates.Read.All|
## HTTP request
v1.0 Teamwork List Teamtemplates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/teamwork-list-teamtemplates.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Team.Create|
+|Delegated (work or school account)|TeamTemplates.Read|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|Team.Create|
+|Application|TeamTemplates.Read.All|
## HTTP request
v1.0 Teamwork Sendactivitynotificationtorecipients https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/teamwork-sendactivitynotificationtorecipients.md
Content-Type: application/json
---- #### Response <!-- {
v1.0 Timeoffrequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/timeoffrequest-list.md
GET https://graph.microsoft.com/beta/teams/{teamId}/schedule/timeOffRequests
-- ### Response The following is an example of the response.
v1.0 Tokenissuancepolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/tokenissuancepolicy-delete.md
DELETE https://graph.microsoft.com/beta/policies/tokenIssuancePolicies/{id}
--- ### Response The following is an example of the response.
v1.0 Tokenissuancepolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/tokenissuancepolicy-get.md
GET https://graph.microsoft.com/beta/policies/tokenIssuancePolicies/{id}
--- ### Response The following is an example of the response.
v1.0 Tokenissuancepolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/tokenissuancepolicy-list.md
GET https://graph.microsoft.com/beta/policies/tokenIssuancePolicies
--- ### Response The following is an example of the response.
v1.0 Tokenissuancepolicy Post Tokenissuancepolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/tokenissuancepolicy-post-tokenissuancepolicy.md
Content-type: application/json
- ### Response The following is an example of the response.
v1.0 Tokenissuancepolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/tokenissuancepolicy-update.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Unifiedroledefinition Assignedprincipals https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroledefinition-assignedprincipals.md
This method supports the `$count`, `$select`, `$filter`, and `$orderBy` OData qu
|Name|Description| |:|:| |Authorization|Bearer {token}. Required.|
-|ConsistencyLevel|eventual. Required. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).|
+|ConsistencyLevel|eventual. Required. For more information about the use of **ConsistencyLevel**, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).|
## Request body Do not supply a request body for this method.
v1.0 Unifiedroledefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroledefinition-get.md
GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/fd
---- #### Response The following is an example of the response.
GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/fd
---- #### Response The following is an example of the response.
v1.0 User Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-delete.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | User.ReadWrite.All |
-The calling user must be assigned one of the following Azure AD roles:
-+ [User Administrator](/azure/active-directory/roles/permissions-reference#user-administrator)
-+ [Privileged Authentication Administrator](/azure/active-directory/roles/permissions-reference#privileged-authentication-administrator)
-+ [Global Administrator](/azure/active-directory/roles/permissions-reference#global-administrator)
+The calling user must be assigned one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference?toc=%2Fgraph%2Ftoc.json):
-To delete users with more privileged administrator roles, applications need to be assigned the *Directory.AccessAsUser.All* delegated permission and either the Global Admin role or the Privileged Auth Admin role.
+- User Administrator
+- Privileged Authentication Administrator
+- Global Administrator
-For more details, see [Azure AD built-in roles](/azure/active-directory/roles/permissions-reference).
+To delete users with privileged administrator roles in delegated scenarios, the app must be assigned the *Directory.AccessAsUser.All* delegated permission, and the calling user must have a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).
+
+In app-only scenarios, the *User.ReadWrite.All* application permission isn't enough privilege to delete users with privileged administrative roles. The app must be assigned a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).
## HTTP request
v1.0 User Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-get.md
Content-type: application/json
} ```
-### Example 4: Get the custom security attribute assignments of the specified user
+### Example 4: Get the custom security attribute assignments for a user
-The following example gets the custom security attributes of the specified user.
+The following example shows how to get the custom security attribute assignments for a user.
Attribute #1
-+ Attribute set: `Engineering`
-+ Attribute: `Project`
-+ Attribute data type: Collection of Strings
-+ Attribute value: `["Baker","Cascade"]`
+- Attribute set: `Engineering`
+- Attribute: `Project`
+- Attribute data type: Collection of Strings
+- Attribute value: `["Baker","Cascade"]`
Attribute #2
-+ Attribute set: `Engineering`
-+ Attribute: `CostCenter`
-+ Attribute data type: Collection of Integers
-+ Attribute value: `[1001]`
+- Attribute set: `Engineering`
+- Attribute: `CostCenter`
+- Attribute data type: Collection of Integers
+- Attribute value: `[1001]`
Attribute #3
-+ Attribute set: `Engineering`
-+ Attribute: `Certification`
-+ Attribute data type: Boolean
-+ Attribute value: `true`
+- Attribute set: `Engineering`
+- Attribute: `Certification`
+- Attribute data type: Boolean
+- Attribute value: `true`
Attribute #4
-+ Attribute set: `Marketing`
-+ Attribute: `Level`
-+ Attribute data type: String
-+ Attribute value: `"Public"`
+- Attribute set: `Marketing`
+- Attribute: `EmployeeId`
+- Attribute data type: String
+- Attribute value: `"QN26904"`
To get custom security attribute assignments, the calling principal must be assigned the Attribute Assignment Reader or Attribute Assignment Administrator role and must be granted the *CustomSecAttributeAssignment.Read.All* or *CustomSecAttributeAssignment.ReadWrite.All* permission.
-#### Request
-
+For more examples of custom security attribute assignments, see [Examples: Assign, update, list, or remove custom security attribute assignments using the Microsoft Graph API](/graph/custom-security-attributes-examples).
+#### Request
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_user_customsecurityattributes"
To get custom security attribute assignments, the calling principal must be assi
GET https://graph.microsoft.com/beta/users/{id}?$select=customSecurityAttributes ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PowerShell](#tab/powershell)
-
-# [PHP](#tab/php)
----- #### Response <!-- {
Content-type: application/json
{ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users(customSecurityAttributes)/$entity", "customSecurityAttributes": {
+ "Marketing": {
+ "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
+ "EmployeeId": "QN26904"
+ },
"Engineering": { "@odata.type": "#microsoft.graph.customSecurityAttributeValue", "Project@odata.type": "#Collection(String)",
Content-type: application/json
1001 ], "Certification": true
- },
- "Marketing": {
- "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
- "Level": "Public"
} } }
Content-type: application/json
"customSecurityAttributes": null } ```+ ### Example 5: Use `$filter` to retrieve specific users based on a property value This example shows how to use the `$filter` query parameter along with the `endswith` clause to retrieve a user with a specific value in the **mail** attribute. This request filters and returns all users with a mail address ending with contoso.com.
v1.0 User List Approleassignedresources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list-approleassignedresources.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /me/appRoleAssignedResources?$count=true
+GET /me/appRoleAssignedResources
ConsistencyLevel: eventual
-GET /users/{userId}/appRoleAssignedResources?$count=true
+GET /users/{userId}/appRoleAssignedResources
ConsistencyLevel: eventual ``` ## Optional query parameters
-This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. The queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. The queries are supported only when you use the **ConsistencyLevel** header set to `eventual`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers |Name|Description| |:|:| |Authorization|Bearer {token}. Required.|
-| ConsistencyLevel | eventual. This header and `$count` are required when calling this API. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
+| ConsistencyLevel | eventual. This header is required when calling this API. For more information about the use of **ConsistencyLevel**, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). |
## 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 [servicePrincipal](../resources/serviceprincipal.md) objects in the response body. If you don't specify the `$count` query parameter and set the **ConsistencyLevel** header to `eventual`, this API returns `404 Not Found error`.
+If successful, this method returns a `200 OK` response code and a collection of [servicePrincipal](../resources/serviceprincipal.md) objects in the response body. If you don't set the **ConsistencyLevel** header to `eventual`, this API returns `404 Not Found error`.
## Examples ### Request The following is an example of a request.
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_approleassignedresources_users" } --> ``` http
-GET https://graph.microsoft.com/beta/me/appRoleAssignedResources?$count=true&$select=displayName,accountEnabled,servicePrincipalType,signInAudience
+GET https://graph.microsoft.com/beta/me/appRoleAssignedResources?$select=displayName,accountEnabled,servicePrincipalType,signInAudience
ConsistencyLevel: eventual ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
----- ### Response The following is an example of the response
v1.0 User List Calendargroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list-calendargroups.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.Read, Calendars.ReadWrite |
-|Delegated (personal Microsoft account) | Calendars.Read, Calendars.ReadWrite |
-|Application | Calendars.Read, Calendars.ReadWrite |
+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
+|Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
+|Application | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 User List Calendars https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list-calendars.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite |
-|Delegated (personal Microsoft account) | Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite |
-|Application | Calendars.Read, Calendars.ReadWrite |
+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite |
+|Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite |
+|Application | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 User List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list-calendarview.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.Read, Calendars.ReadWrite |
-|Delegated (personal Microsoft account) | Calendars.Read, Calendars.ReadWrite |
-|Application | Calendars.Read, Calendars.ReadWrite |
+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
+|Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite|
+|Application | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
## HTTP request A user's default [calendar](../resources/calendar.md).
v1.0 User List Cloudpcs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list-cloudpcs.md
ms.prod: "cloud-pc"
doc_type: apiPageType
-# List cloudPCs
+# List cloudPCs for user
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
Content-Type: application/json
"lastModifiedDateTime": "2020-11-03T10:29:57Z", "statusDetails": null, "gracePeriodEndDateTime": "2020-11-010T20:00:34Z",
+ "provisioningType": "dedicated",
"diskEncryptionState": "encryptedUsingPlatformManagedKey" } ]
v1.0 User List Events https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list-events.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.Read, Calendars.ReadWrite |
-|Delegated (personal Microsoft account) | Calendars.Read, Calendars.ReadWrite |
-|Application | Calendars.Read, Calendars.ReadWrite |
+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
+|Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite|
+|Application | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 User List Manager https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list-manager.md
Returns the user or organizational contact assigned as the user's manager. Optio
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
+| Permission type | Permissions (from least to most privileged) |
+| :- | :-- |
+| Delegated (work or school account) | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
[!INCLUDE [limited-info](../../includes/limited-info.md)]
Get the
GET /me/manager GET /users/{id | userPrincipalName}/manager ```+ Get the management chain: <!-- { "blockType": "ignored" } --> ```http
-GET /me?$expand=manager
-GET /users?$expand=manager($levels=n)
+GET /users?$expand=manager
GET /users/{id | userPrincipalName}/?$expand=manager($levels=n) ```
GET /users/{id | userPrincipalName}/?$expand=manager($levels=n)
This method supports the `$select` and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response.
->**Note:**
-> + The `n` value of `$levels` can be `max` (to return all managers) or a number between 1 and 1000.
+>**Note:**
+>
+> + The `n` value of `$levels` can be `max` (to return all managers) or a number between 1 and 1000.
> + When the `$levels` parameter is not specified, only the immediate manager is returned.
-> + You can specify `$select` inside `$expand` to select the individual manager's properties. The `$levels` parameter is required: `$expand=manager($levels=max;$select=id,displayName)`.
+> + You can specify `$select` inside `$expand` to select the individual manager's properties: `$expand=manager($levels=max;$select=id,displayName)`.
+> + `$levels` parameter is only supported on a single user (`/users/{id}` or `me` endpoints) and not on the entire list of users.
+> + `$levels` requires the **ConsistencyLevel** header set to `eventual`. For more information about the use of **ConsistencyLevel**, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers
-| Header | Value|
-|:--|:|
-| Authorization | Bearer {token}. Required. |
-| ConsistencyLevel | eventual. Required when the request includes the `$count=true` query string. |
+| Header | Value |
+| : | : |
+| Authorization | Bearer {token}. Required. |
+| ConsistencyLevel | eventual. Required when the request includes the `$levels=n` in the `$expand` query parameter. |
## Request body
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a [directoryObject](../resources/directoryobject.md) object in the response body.
+If successful, this method returns a `200 OK` response code and a [user](../resources/user.md) object in the response body.
## Examples
GET https://graph.microsoft.com/beta/users/{id|userPrincipalName}/manager
``` # [C#](#tab/csharp)+ [!INCLUDE [sample-code](../includes/snippets/csharp/get-manager-2-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript)+ [!INCLUDE [sample-code](../includes/snippets/javascript/get-manager-2-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java)+ [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go)+ [!INCLUDE [sample-code](../includes/snippets/go/get-manager-2-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)+ [!INCLUDE [sample-code](../includes/snippets/powershell/get-manager-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php)+ [!INCLUDE [sample-code](../includes/snippets/php/get-manager-2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-type: application/json
### Example 2: Get manager chain up to the root level
-The following example shows a request to get the manager chain up to the root level. This request requires the **ConsistencyLevel** header set to `eventual` because `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+The following example shows a request to get the manager chain up to the root level.
#### Request -- # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_transitive_managers" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/me?$expand=manager($levels=max;$select=id,displayName)&$select=id,displayName&$count=true
+GET https://graph.microsoft.com/beta/me?$expand=manager($levels=max;$select=id,displayName)&$select=id,displayName
ConsistencyLevel: eventual ``` # [C#](#tab/csharp)+ [!INCLUDE [sample-code](../includes/snippets/csharp/get-transitive-managers-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript)+ [!INCLUDE [sample-code](../includes/snippets/javascript/get-transitive-managers-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java)+ [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go)+ [!INCLUDE [sample-code](../includes/snippets/go/get-transitive-managers-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)+ [!INCLUDE [sample-code](../includes/snippets/powershell/get-transitive-managers-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php)+ [!INCLUDE [sample-code](../includes/snippets/php/get-transitive-managers-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -- #### Response The following is an example of the response. Transitive managers are displayed hierarchically.
Content-type: application/json
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
-<!--
-{
+<!-- {
"type": "#page.annotation", "description": "List directReports", "keywords": "", "section": "documentation", "tocPath": "",
- "suppressions": []
-}
>
+ "suppressions": [
+ ]
+}-->
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list.md
Content-type: application/json
> **Note:** You can also apply `$filter` on the schema extension property to retrieve objects where a property in the collection matches a specified value. The syntax is `/users?$filter={schemaPropertyID}/{propertyName} eq 'value'`. For example, `GET /users?$select=ext55gb1l09_msLearnCourses&$filter=ext55gb1l09_msLearnCourses/courseType eq 'Developer'`. The `eq` and `not` operators are supported.
+### Example 13: List all users with a custom security attribute assignment that equals a value
+
+The following example shows how to list all users with a custom security attribute assignment that equals a value. The example retrieves users with a custom security attribute named `AppCountry` with a value that equals `Canada`. The filter value is case sensitive. You must add `ConsistencyLevel=eventual` in the request or the header. You must also include `$count=true` to ensure the request is routed correctly.
+
+User #1
+
+- Attribute set: `Marketing`
+- Attribute: `AppCountry`
+- Attribute data type: Collection of Strings
+- Attribute value: `["India","Canada"]`
+
+User #2
+
+- Attribute set: `Marketing`
+- Attribute: `AppCountry`
+- Attribute data type: Collection of Strings
+- Attribute value: `["Canada","Mexico"]`
+
+To get custom security attribute assignments, the calling principal must be assigned the Attribute Assignment Reader or Attribute Assignment Administrator role and must be granted the *CustomSecAttributeAssignment.Read.All* or *CustomSecAttributeAssignment.ReadWrite.All* permission.
+
+For examples of custom security attribute assignments, see [Examples: Assign, update, list, or remove custom security attribute assignments using the Microsoft Graph API](/graph/custom-security-attributes-examples).
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "customsecurityattribute_filter_users_equals_value"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/users?$count=true&$select=id,displayName,customSecurityAttributes&$filter=customSecurityAttributes/Marketing/AppCountry eq 'Canada'
+ConsistencyLevel: eventual
+```
+
+#### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.user"
+} -->
+```http
+HTTP/1.1 200 OK
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users(id,displayName,customSecurityAttributes)",
+ "@odata.count": 2,
+ "value": [
+ {
+ "id": "dbaf3778-4f81-4ea0-ac1c-502a293c12ac",
+ "displayName": "Jiya",
+ "customSecurityAttributes": {
+ "Engineering": {
+ "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
+ "Datacenter@odata.type": "#Collection(String)",
+ "Datacenter": [
+ "India"
+ ]
+ },
+ "Marketing": {
+ "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
+ "AppCountry@odata.type": "#Collection(String)",
+ "AppCountry": [
+ "India",
+ "Canada"
+ ],
+ "EmployeeId": "KX19476"
+ }
+ }
+ },
+ {
+ "id": "6bac433c-48c6-4213-a316-1428de32701b",
+ "displayName": "Jana",
+ "customSecurityAttributes": {
+ "Marketing": {
+ "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
+ "AppCountry@odata.type": "#Collection(String)",
+ "AppCountry": [
+ "Canada",
+ "Mexico"
+ ],
+ "EmployeeId": "GS46982"
+ }
+ }
+ }
+ ]
+}
+```
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 User Reminderview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-reminderview.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.Read, Calendars.ReadWrite |
-|Delegated (personal Microsoft account) | Calendars.Read, Calendars.ReadWrite |
-|Application | Calendars.Read, Calendars.ReadWrite |
+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
+|Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
+|Application | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 User Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-update.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | User.ReadWrite, User.ReadWrite.All, User.ManageIdentities.All, Directory.ReadWrite.All |
+|Delegated (work or school account) | User.ReadWrite, User.ManageIdentities.All, User.EnableDisableAccount.All, User.ReadWrite.All, Directory.ReadWrite.All |
|Delegated (personal Microsoft account) | User.ReadWrite |
-|Application | User.ReadWrite.All, User.ManageIdentities.All, Directory.ReadWrite.All |
+|Application | User.ManageIdentities.All, User.EnableDisableAccount.All, User.ReadWrite.All, Directory.ReadWrite.All |
>[!NOTE]
-> - To update user properties, such as **businessPhones**, **mobilePhone** and **otherMails** for users with more privileged administrator roles, applications need to be assigned the *Directory.AccessAsUser.All* delegated permission and either the Global Admin role or the Privileged Auth Admin role. For more information about who can update sensitive properties or reset passwords, see [Authorization and privileges](/graph/api/resources/users#authorization-and-privileges).
+> - To update sensitive user properties, such as **accountEnabled**, **mobilePhone**, and **otherMails** for users with privileged administrator roles, the app must be assigned the *Directory.AccessAsUser.All* delegated permission, and the calling user must have a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).
> - Your personal Microsoft account must be tied to an Azure AD tenant to update your profile with the *User.ReadWrite* delegated permission on a personal Microsoft account. > - Updating the **identities** property requires the *User.ManageIdentities.All* permission. Also, adding a [B2C local account](../resources/objectidentity.md) to an existing **user** object is not allowed, unless the **user** object already contains a local account identity.
The following example shows how to assign a custom security attribute with a str
To assign custom security attributes, the calling principal must be assigned the Attribute Assignment Administrator role and must be granted the *CustomSecAttributeAssignment.ReadWrite.All* permission.
-For more examples for users, see [Assign, update, or remove custom security attributes using the Microsoft Graph API](/graph/custom-security-attributes-examples).
+For examples of custom security attribute assignments, see [Examples: Assign, update, list, or remove custom security attribute assignments using the Microsoft Graph API](/graph/custom-security-attributes-examples).
#### Request
v1.0 Userteamwork Delete Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/userteamwork-delete-installedapps.md
Namespace: microsoft.graph
Uninstall an [app](../resources/teamsappinstallation.md) from the personal scope of the specified [user](../resources/user.md).
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
v1.0 Userteamwork Get Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/userteamwork-get-installedapps.md
Namespace: microsoft.graph
Retrieve the [app](../resources/teamsappinstallation.md) installed in the personal scope of the specified [user](../resources/user.md).
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
v1.0 Userteamwork List Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/userteamwork-list-installedapps.md
Namespace: microsoft.graph
Retrieve the list of [apps](../resources/teamsappinstallation.md) installed in the personal scope of the specified [user](../resources/user.md).
-> [!NOTE]
-> The `id` of a **teamsAppInstallation** resource is not the same value as the `id` of the associated **teamsApp** resource.
+>**Notes:**
+> - The `id` of a **teamsAppInstallation** resource is not the same value as the `id` of the associated **teamsApp** resource.
+> - This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
## Permissions
v1.0 Userteamwork Post Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/userteamwork-post-installedapps.md
Namespace: microsoft.graph
Install an [app](../resources/teamsapp.md) in the personal scope of the specified [user](../resources/user.md).
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
v1.0 Userteamwork Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/userteamwork-sendactivitynotification.md
Content-Type: application/json
- #### Response+ <!-- { "blockType": "response", "truncated": false
Content-Type: application/json
``` http HTTP/1.1 204 No Content ```+
+## See also
+
+- [Activity feed notification C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/csharp)
+- [Activity feed notification Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/nodejs)
v1.0 Userteamwork Teamsappinstallation Upgrade https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/userteamwork-teamsappinstallation-upgrade.md
Namespace: microsoft.graph
Upgrade an [app installation](../resources/teamsappinstallation.md) in the personal scope of the specified [user](../resources/user.md) to the latest version of the app.
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
v1.0 Virtualendpoint List Cloudpcs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/virtualendpoint-list-cloudpcs.md
Content-Type: application/json
"lastModifiedDateTime": "2020-11-03T10:29:57Z", "statusDetails": null, "gracePeriodEndDateTime": "2020-11-010T20:00:34Z",
+ "provisioningType": "dedicated",
"diskEncryptionState": "encryptedUsingPlatformManagedKey" } ]
v1.0 Virtualendpoint List Provisioningpolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/virtualendpoint-list-provisioningpolicies.md
Content-Type: application/json
"onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff", "type": "hybridAzureADJoin" },
+ "enableSingleSignOn": true,
"id": "1d164206-bf41-4fd2-8424-a3192d39ffff", "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff", "imageDisplayName": "Image Display Name value",
Content-Type: application/json
"windowsSettings": { "language": "en-US" },
- "managedBy": "windows365"
+ "managedBy": "windows365",
+ "provisioningType": "dedicated"
} ] }
v1.0 Virtualendpoint List Shareduseserviceplans https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/virtualendpoint-list-shareduseserviceplans.md
+
+ Title: "List cloudPcSharedUseServicePlans"
+description: "Get a list of the cloudPcSharedUseServicePlan objects and their properties."
+
+ms.localizationpriority: medium
++
+# List cloudPcSharedUseServicePlans
+
+Namespace: microsoft.graph
++
+Get a list of the [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) objects and their properties.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+| :- | : |
+| Delegated (work or school account) | CloudPC.Read.All, CloudPC.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | CloudPC.Read.All, CloudPC.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /deviceManagement/virtualEndpoint/sharedUseServicePlans
+```
+
+## Optional query parameters
+
+This method supports the `$select`, `$filter`, `$orderBy`, and `$skip` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+| Name | Description |
+| : | : |
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "list_cloudpcshareduseserviceplans"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/sharedUseServicePlans
+```
+
+### Response
+
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.cloudPcSharedUseServicePlan",
+ "isCollection": true
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.cloudPcSharedUseServicePlan",
+ "id": "1d164206-bf41-4fd2-8424-a3192d39ffff",
+ "displayName": "Display Name value",
+ "usedCount": 5,
+ "totalCount": 10
+ }
+ ]
+}
+```
v1.0 Virtualendpoint Post Provisioningpolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/virtualendpoint-post-provisioningpolicies.md
The following table shows the properties that are required when you create the [
|Property|Type|Description| |:|:|:|
-|displayName|String|The display name for the provisioning policy.|
|description|String|The provisioning policy description.|
+|displayName|String|The display name for the provisioning policy.|
|domainJoinConfiguration|[cloudPcDomainJoinConfiguration](../resources/cloudpcdomainjoinconfiguration.md)|Specifies how Cloud PCs will join Azure Active Directory.|
-|onPremisesConnectionId|String|The ID of the cloudPcOnPremisesConnection. To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network thatΓÇÖs validated by the Cloud PC service.|
-|imageId|String|The ID of the OS image you want to provision on Cloud PCs. The format for a gallery type image is: {publisher_offer_sku}. Supported values for each of the parameters are as follows:<ul><li>publisher: Microsoftwindowsdesktop.</li> <li>offer: windows-ent-cpc.</li> <li>sku: 21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-m365, 20h1-ent-cpc-os, 19h2-ent-cpc-m365 and 19h2-ent-cpc-os.</li></ul>|
|imageDisplayName|String|The display name for the OS image youΓÇÖre provisioning.|
+|imageId|String|The ID of the OS image you want to provision on Cloud PCs. The format for a gallery type image is: {publisher_offer_sku}. Supported values for each of the parameters are as follows:<ul><li>publisher: Microsoftwindowsdesktop.</li> <li>offer: windows-ent-cpc.</li> <li>sku: 21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-m365, 20h1-ent-cpc-os, 19h2-ent-cpc-m365 and 19h2-ent-cpc-os.</li></ul>|
|imageType|cloudPcProvisioningPolicyImageType|The type of OS image (custom or gallery) you want to provision on Cloud PCs. Possible values are: `gallery`, `custom`.|
+|onPremisesConnectionId|String|The ID of the cloudPcOnPremisesConnection. To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network thatΓÇÖs validated by the Cloud PC service.|
+|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|Specifies the type of license used when provisioning Cloud PCs using this policy. By default, the license type is `dedicated` if the **provisioningType** isn't specified when you create the **cloudPcProvisioningPolicy**. You can't change this property after the **cloudPcProvisioningPolicy** was created. Possible values are: `dedicated`, `shared`, `unknownFutureValue`.|
|windowsSettings|[cloudPcWindowsSettings](../resources/cloudpcwindowssettings.md)|Specific Windows settings to configure while creating Cloud PCs for this provisioning policy.| ## Response
If successful, this method returns a `201 Created` response code and a [cloudPcP
### Request
+The following is an example of a request.
# [HTTP](#tab/http) <!-- {
Content-Type: application/json
"domainJoinType": "hybridAzureADJoin", "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff" },
- "id": "1d164206-bf41-4fd2-8424-a3192d39ffff",
+ "enableSingleSignOn": true,
"imageDisplayName": "Windows-10 19h1-evd", "imageId": "MicrosoftWindowsDesktop_Windows-10_19h1-evd", "imageType":"gallery", "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff", "windowsSettings": { "language": "en-US"
- }
+ },
+ "provisioningType": "dedicated"
} ```
Content-Type: application/json
### Response
-**Note:** The response object shown here might be shortened for readability.
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Content-Type: application/json
"onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff", "type": "hybridAzureADJoin" },
+ "enableSingleSignOn": true,
"id": "1d164206-bf41-4fd2-8424-a3192d39ffff", "imageDisplayName": "Windows-10 19h1-evd", "imageId": "MicrosoftWindowsDesktop_Windows-10_19h1-evd",
Content-Type: application/json
"windowsSettings": { "language": "en-US" },
- "managedBy": "windows365"
+ "managedBy": "windows365",
+ "provisioningType": "dedicated"
} ```
v1.0 Workbookrange Resizedrange https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/workbookrange-resizedrange.md
Title: "workbookRange: resizedRange"
-description: "Gets a range object similar to the current range object, but with its bottom-right corner expanded (or contracted) by some number of rows and columns."
+description: "Get a range object similar to the current range object, but with its bottom-right corner expanded (or contracted) by some number of rows and columns."
ms.localizationpriority: medium ms.prod: "excel"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Gets a range object similar to the current range object, but with its bottom-right corner expanded (or contracted) by some number of rows and columns.
+Get a range object similar to the current range object, but with its bottom-right corner expanded (or contracted) by some number of rows and columns.
## 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).
One of the following permissions is required to call this API. To learn more, in
```http POST /me/drive/items/{id}/workbook/worksheets/{id}/range/resizedRange(deltaRows={n}, deltaColumns={n}) POST /me/drive/root:/{item-path}:/workbook/worksheets/{id}/range/resizedRange(deltaRows={n}, deltaColumns={n})- ``` ## Function parameters
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id}/range/resizedRange(de
| Name | Description| |:|:-| | Authorization | Bearer {token}. Required. |
-| Workbook-Session-Id | Workbook session Id that determines if changes are persisted or not. Optional.|
+| Workbook-Session-Id | Workbook session ID that determines if changes are persisted or not. Optional.|
## Request body Do not supply a request body for this method. ## Response
-If successful, this method returns `200 OK` response code and [workbookRange](../resources/workbookrange.md) object in the response body.
+If successful, this method returns a `200 OK` response code and a [workbookRange](../resources/workbookrange.md) object in the response body.
## Example
-Here is an example of how to call this API.
-##### Request
-Here is an example of the request.
+
+### Request
+The following is an example of the request.
<!-- { "blockType": "request", "name": "workbookrange_resizedrange"
Here is an example of the request.
POST https://graph.microsoft.com/beta/drive/root/workbook/worksheets/{id}/range/resizedRange(deltarows={n}, deltaColumns={n}) ```
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Alternativesecurityid https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/alternativeSecurityId.md
description: "For internal use only. This complex type will be deprecated in the
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "directory-management"-+ # alternativeSecurityId resource type
v1.0 Callrecords Pstncalllogrow https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/callrecords-pstncalllogrow.md
Title: "pstnCallLogRow resource type"
-description: "Represents a row of data in the Public Switch Telephone Network (PSTN) call log."
+description: "Represents a row of data in the public switched telephone network (PSTN) call log."
ms.localizationpriority: medium ms.prod: "cloud-communications"
Namespace: microsoft.graph.callRecords
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a row of data in the Public Switch Telephone Network (PSTN) call log. Each row maps to one call.
+Represents a row of data in the public switched telephone network (PSTN) call log. Each row maps to one call.
## Methods
Represents a row of data in the Public Switch Telephone Network (PSTN) call log.
|charge|Double|Amount of money or cost of the call that is charged to your account.| |conferenceId|String|ID of the audio conference.| |connectionCharge|Double|Connection fee price.|
-|currency|String|Type of currency used to calculate the cost of the call ([ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)).|
+|currency|String|Type of currency used to calculate the cost of the call. For details, see [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).|
|destinationContext|String|Whether the call was domestic (within a country or region) or international (outside a country or region) based on the user's location.| |destinationName|String|Country or region dialed.| |duration|Int32|How long the call was connected, in seconds.|
Represents a row of data in the Public Switch Telephone Network (PSTN) call log.
|licenseCapability|String|The license used for the call.| |operator|String|The telecommunications operator which provided PSTN services for this call. This may be Microsoft, or it may be a third-party operator via the [Operator Connect Program](https://techcommunity.microsoft.com/t5/microsoft-teams-blog/introducing-operator-connect-and-more-teams-calling-updates/ba-p/2176398).| |startDateTime|DateTimeOffset|Call start time.|
-|tenantCountryCode|String|Country code of the tenant, [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
-|usageCountryCode|String|Country code of the user, [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
+|tenantCountryCode|String|Country code of the tenant. For details, see [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
+|usageCountryCode|String|Country code of the user. For details, see [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
|userDisplayName|String|Display name of the user.| |userId|String|Calling user's ID in Graph. GUID. This and other user info will be null/empty for bot call types (ucap_in, ucap_out).|
-|userPrincipalName|String|UserPrincipalName (sign-in name) in Azure Active Directory. This is usually the same as user's SIP Address, and can be same as user's e-mail address.|
+|userPrincipalName|String|The user principal name (sign-in name) in Azure Active Directory. This is usually the same as the user's SIP address, and can be same as the user's e-mail address.|
## Relationships
The following is a JSON representation of the resource.
``` json { "@odata.type": "#microsoft.graph.callRecords.pstnCallLogRow",
- "id": "String (identifier)",
+ "callDurationSource": "String",
"callId": "String",
- "userId": "String",
- "userPrincipalName": "String",
- "userDisplayName": "String",
- "startDateTime": "String (timestamp)",
- "endDateTime": "String (timestamp)",
- "duration": "Integer",
- "charge": "Double",
"callType": "String",
- "currency": "String",
"calleeNumber": "String",
- "usageCountryCode": "String",
- "tenantCountryCode": "String",
- "connectionCharge": "Double",
"callerNumber": "String",
+ "charge": "Double",
+ "conferenceId": "String",
+ "connectionCharge": "Double",
+ "currency": "String",
"destinationContext": "String", "destinationName": "String",
- "conferenceId": "String",
- "licenseCapability": "String",
+ "duration": "Integer",
+ "endDateTime": "String (timestamp)",
+ "id": "String (identifier)",
"inventoryType": "String",
+ "licenseCapability": "String",
"operator": "String",
- "callDurationSource": "String"
+ "startDateTime": "String (timestamp)",
+ "tenantCountryCode": "String",
+ "usageCountryCode": "String",
+ "userDisplayName": "String",
+ "userId": "String",
+ "userPrincipalName": "String"
} ```
v1.0 Calltranscript https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/calltranscript.md
Represents a transcript associated with an [online meeting](onlinemeeting.md).
| Property | Type |Description| |:|:--|:-|
-| id| String| The transcript's unique identifier. Read-only.|
-| createdDateTime| dateTimeOffset| Date and time at which the transcript was created. Read-only.|
-| content| Stream| A field representing the content of the transcript. Read-only.|
+| content| Stream| A field that represents the content of the transcript. Read-only.|
+| createdDateTime| DateTimeOffset| Date and time at which the transcript was created. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.|
+| id| String| The unique identifier for the transcript. Read-only.|
+ ## JSON representation
-Here is a JSON representation of the resource.
+The following is a JSON representation of the resource.
<!-- { "blockType": "resource",
Here is a JSON representation of the resource.
```json {
- "id": "string (identifier)",
- "createdDateTime": "dateTimeOffset",
- "content": "stream"
+ "content": "stream",
+ "createdDateTime": "dateTimeOffset",
+ "id": "string (identifier)"
} ```
v1.0 Changenotificationcollection https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/changenotificationcollection.md
None.
| Property | Type | Description | |:|:--|:|
-| validationTokens | collection(string) | Contains an array of JWT tokens generated by Microsoft Graph for the application to validate the origin of the notifications. Microsoft Graph generates a single token for each distinct app and tenant pair for an item if it exists in the value array. Keep in mind that notifications can contain a mix of items for various apps and tenants that subscribed using the same notification URL. Only provided for [change notifications with resource data](/graph/webhooks-with-resource-data.md) Optional. |
-| value | collection([changeNotification](changenotification.md)) | The set of notifications being sent to the notification URL. Required. |
+| validationTokens | String collection | Contains an array of JWT tokens generated by Microsoft Graph for the application to validate the origin of the notifications. Microsoft Graph generates a single token for each distinct app and tenant pair for an item if it exists in the value array. Keep in mind that notifications can contain a mix of items for various apps and tenants that subscribed using the same notification URL. Only provided for [change notifications with resource data](/graph/webhooks-with-resource-data.md) Optional. |
+| value | [changeNotification](changenotification.md) collection | The set of notifications being sent to the notification URL. Required. |
## Relationships
v1.0 Changenotificationencryptedcontent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/changenotificationencryptedcontent.md
Namespace: microsoft.graph
Represents the encrypted data attached to a change notification.
-For details, see [Set up change notifications that include resource data (preview)](/graph/webhooks-with-resource-data.md).
+For details, see [Set up change notifications that include resource data](/graph/webhooks-with-resource-data).
## Properties
v1.0 Channel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/channel.md
The following is a JSON representation of the resource.
"suppressions": [] } -->+
+## See also
+
+- [Channel lifecycle C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-channel-lifecycle/csharp)
+- [Channel lifecycle Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-channel-lifecycle/nodejs)
v1.0 Chat https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/chat.md
The following is a JSON representation of the resource.
- [channel](channel.md) - [chatMessage](chatmessage.md)
+- [Chat lifecycle C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-chat-lifecycle/csharp)
+- [Chat lifecycle Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-chat-lifecycle/nodejs)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Cloudpc https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpc.md
Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled into
|managedDeviceName|String|The Intune device name of the Cloud PC.| |onPremisesConnectionName|String|The Azure network connection that is applied during the provisioning of Cloud PCs.| |osVersion|[cloudPcOperatingSystem](../resources/cloudpcorganizationsettings.md#cloudpcoperatingsystem-values)|The version of the operating system (OS) to provision on Cloud PCs. Possible values are: `windows10`, `windows11`, and `unknownFutureValue`.|
+|partnerAgentInstallResults|[cloudPcPartnerAgentInstallResult](../resources/cloudpcpartneragentinstallresult.md) collection|The results of every partner agent's installation status on Cloud PC.|
|provisioningPolicyId|String|The provisioning policy ID of the Cloud PC.| |provisioningPolicyName|String|The provisioning policy that is applied during the provisioning of Cloud PCs.|
-|partnerAgentInstallResults|[cloudPcPartnerAgentInstallResult](../resources/cloudpcpartneragentinstallresult.md) collection|The results of every partner agent's installation status on Cloud PC.|
+|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`. Default value is `dedicated`. |
|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.|
The following is a JSON representation of the resource.
``` json { "@odata.type": "#microsoft.graph.cloudPC",
- "id": "String (identifier)",
+ "aadDeviceId": "String",
+ "connectivityResult": "String",
+ "diskEncryptionState": "String",
"displayName": "String",
+ "gracePeriodEndDateTime": "String (timestamp)",
+ "id": "String (identifier)",
"imageDisplayName": "String",
- "aadDeviceId": "String",
+ "lastLoginResult": "String",
+ "lastModifiedDateTime": "String (timestamp)",
+ "lastRemoteActionResult": "String",
"managedDeviceId": "String", "managedDeviceName": "String",
+ "onPremisesConnectionName": "String",
+ "osVersion": "String",
+ "partnerAgentInstallResults": "String",
"provisioningPolicyId": "String", "provisioningPolicyName": "String",
- "partnerAgentInstallResults": "String",
- "onPremisesConnectionName": "String",
+ "provisioningType": "String",
"servicePlanId": "String",
- "servicePlanType": "String",
"servicePlanName": "String",
+ "servicePlanType": "String",
"status": "String",
- "userPrincipalName": "String",
- "lastModifiedDateTime": "String (timestamp)",
- "gracePeriodEndDateTime": "String (timestamp)",
"userAccountType": "String",
- "osVersion": "String",
- "lastRemoteActionResult": "String",
- "lastLoginResult": "String",
- "connectivityResult": "String",
- "diskEncryptionState": "String"
+ "userPrincipalName": "String"
} ```
v1.0 Cloudpcdomainjoinconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpcdomainjoinconfiguration.md
Represents a defined configuration of how a provisioned Cloud PC device will be
|Property|Type|Description| |:|:|:| |onPremisesConnectionId|String|The Azure network connection ID that matches the virtual network IT admins want the provisioning policy to use when they create Cloud PCs. You can use this property in both domain join types: _Azure AD joined_ or _Hybrid Azure AD joined_. If you enter an **onPremisesConnectionId**, leave **regionName** as empty.|
+|regionGroup|[cloudPcRegionGroup](../resources/cloudpcsupportedregion.md#cloudpcregiongroup-values)|The logical geographic group this region belongs to. Multiple regions can belong to one region group. A customer can select a **regionGroup** when provisioning a Cloud PC, and the Cloud PC will be put in one of the regions in the group based on resource status. For example, the Europe region group contains the Northern Europe and Western Europe regions. Possible values are: `default`, `australia`, `canada`, `usCentral`, `usEast`, `usWest`, `france`, `germany`, `europeUnion`, `unitedKingdom`, `japan`, `asia`, `india`, `southAmerica`, `euap`, `usGovernment`, `usGovernmentDOD`, `unknownFutureValue`, `norway`, `switzerland`, and `southKorea`. Read-only.|
|regionName|String|The supported Azure region where the IT admin wants the provisioning policy to create Cloud PCs. The underlying virtual network will be created and managed by the Windows 365 service. This can only be entered if the IT admin chooses Azure AD joined as the domain join type. If you enter a **regionName**, leave **onPremisesConnectionId** as empty.| |type|[cloudPcDomainJoinType](#cloudpcdomainjointype-values)|Specifies how the provisioned Cloud PC will be joined to Azure AD. If you choose the `hybridAzureADJoin` type, only provide a value for the **onPremisesConnectionId** property and leave **regionName** as empty. If you choose the `azureADJoin` type, provide a value for either **onPremisesConnectionId** or **regionName**. The possible values are: `azureADJoin`, `hybridAzureADJoin`, `unknownFutureValue`.| + ### cloudPcDomainJoinType values |Member|Description|
The following is a JSON representation of the resource.
"@odata.type": "#microsoft.graph.cloudPcDomainJoinConfiguration", "type": "String", "regionName": "String",
- "onPremisesConnectionId": "String"
+ "onPremisesConnectionId": "String",
+ "regionGroup": {
+ "@odata.type": "#microsoft.graph.cloudPcRegionGroup"
+ }
} ```
v1.0 Cloudpcmanagementgroupassignmenttarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpcmanagementgroupassignmenttarget.md
Inherits from [cloudPcManagementAssignmentTarget](../resources/cloudpcmanagement
|Property|Type|Description| |:|:|:|
-|groupId|String|The id of the assignment's target group|
+|groupId|String|The ID of the target group for the assignment. |
+|servicePlanId|String|The unique identifier for the service plan that indicates which size of the Cloud PC to provision for the user. Use a `null` value, when the **provisioningType** is `dedicated`.|
## Relationships
The following is a JSON representation of the resource.
``` json { "@odata.type": "#microsoft.graph.cloudPcManagementGroupAssignmentTarget",
- "groupId": "String"
+ "groupId": "String",
+ "servicePlanId": "String"
} ```
v1.0 Cloudpcorganizationsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpcorganizationsettings.md
Represents the Cloud PC organization settings for a tenant. A tenant has only on
## Properties |Property|Type|Description| |:|:|:|
-|enableMEMAutoEnroll|Boolean|Specifies whether new Cloud PCs will be automatically enrolled in Microsoft Endpoint Manager(MEM). The default value is `false`.|
+|enableMEMAutoEnroll|Boolean|Specifies whether new Cloud PCs will be automatically enrolled in Microsoft Endpoint Manager (MEM). The default value is `false`.|
+|enableSingleSignOn|Boolean|`True` if the provisioned Cloud PC can be accessed by single sign-on. `False` indicates that the provisioned Cloud PC doesn't support this feature. Default value is `false`. Windows 365 users can use single sign-on to authenticate to Azure Active Directory (Azure AD) with passwordless options (for example, FIDO keys) to access their Cloud PC. Optional.|
|id|String|The ID of the organization settings.| |osVersion|[cloudPcOperatingSystem](#cloudpcoperatingsystem-values)|The version of the operating system (OS) to provision on Cloud PCs. The possible values are: `windows10`, `windows11`, `unknownFutureValue`.| |userAccountType|[cloudPcUserAccountType](#cloudpcuseraccounttype-values)|The account type of the user on provisioned Cloud PCs. The possible values are: `standardUser`, `administrator`, `unknownFutureValue`.|
The following is a JSON representation of the resource.
{ "@odata.type": "#microsoft.graph.cloudPcOrganizationSettings", "enableMEMAutoEnroll": "Boolean",
+ "enableSingleSignOn": "Boolean",
"id": "String (identifier)", "osVersion": "String", "userAccountType": "String",
v1.0 Cloudpcprovisioningpolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpcprovisioningpolicy.md
Represents a Cloud PC provisioning policy.
|description|String|The provisioning policy description.| |displayName|String|The display name for the provisioning policy.| |domainJoinConfiguration|[cloudPcDomainJoinConfiguration](../resources/cloudpcdomainjoinconfiguration.md)|Specifies how Cloud PCs will join Azure Active Directory.|
+|enableSingleSignOn|Boolean|`True` if the provisioned Cloud PC can be accessed by single sign-on. `False` indicates that the provisioned Cloud PC doesn't support this feature. Default value is `false`. Windows 365 users can use single sign-on to authenticate to Azure Active Directory (Azure AD) with passwordless options (for example, FIDO keys) to access their Cloud PC. Optional.|
|gracePeriodInHours|Int32|The number of hours to wait before reprovisioning/deprovisioning happens. Read-only.| |id|String|Unique identifier for the Cloud PC provisioning policy. Read-only.| |imageDisplayName|String|The display name for the OS image youΓÇÖre provisioning.|
Represents a Cloud PC provisioning policy.
|managedBy|[cloudPcManagementService](../resources/cloudpconpremisesconnection.md#cloudpcmanagementservice-values)|Specifies which services manage the Azure network connection. Possible values are: `windows365`, `devBox`, `unknownFutureValue`, `rpaBox`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `rpaBox`. Read-only.| |microsoftManagedDesktop|[microsoftManagedDesktop](../resources/microsoftManagedDesktop.md)|The specific settings for the Microsoft Managed Desktop, which enables customers to get a managed device experience for the Cloud PC. Before you can enable Microsoft Managed Desktop, an admin must configure it.| |onPremisesConnectionId|String|The ID of the cloudPcOnPremisesConnection. To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network thatΓÇÖs validated by the Cloud PC service.|
+|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|Specifies the type of license used when provisioning Cloud PCs using this policy. By default, the license type is `dedicated` if the **provisioningType** isn't specified when you create the **cloudPcProvisioningPolicy**. You can't change this property after the **cloudPcProvisioningPolicy** was created. Possible values are: `dedicated`, `shared`, `unknownFutureValue`.|
|windowsSettings|[cloudPcWindowsSettings](../resources/cloudpcwindowssettings.md)|Specific Windows settings to configure while creating Cloud PCs for this provisioning policy.|
+### cloudPcProvisioningType values
+
+| Member | Description |
+|:--|:--|
+| dedicated | Indicates that a dedicated license is used for provisioning Cloud PCs. Default value. |
+| shared | Indicates that a shared license is used for provisioning Cloud PCs. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. |
+ ## Relationships |Relationship|Type|Description| |:|:|:|
-|assignments|[cloudPcProvisioningPolicyAssignment](../resources/cloudpcprovisioningpolicyassignment.md) collection|A defined collection of provisioning policy assignments. Represents the set of Microsoft 365 groups and security groups in Azure AD that have provisioning policy assigned. Returned only on `$expand`. See an [example](../api/cloudpcprovisioningpolicy-get.md) of getting the assignments relationship. |
+|assignments|[cloudPcProvisioningPolicyAssignment](../resources/cloudpcprovisioningpolicyassignment.md) collection|A defined collection of provisioning policy assignments. Represents the set of Microsoft 365 groups and security groups in Azure AD that have provisioning policy assigned. Returned only on `$expand`. For an example about how to get the assignments relationship, see [Get cloudPcProvisioningPolicy](../api/cloudpcprovisioningpolicy-get.md). |
## JSON representation
The following is a JSON representation of the resource.
"domainJoinConfiguration": { "@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration" },
- "gracePeriodInHours": "Integer",
+ "enableSingleSignOn": "Boolean",
+ "gracePeriodInHours": "Int32",
"id": "String (identifier)", "imageDisplayName": "String", "imageId": "String",
The following is a JSON representation of the resource.
"localAdminEnabled": "Boolean", "managedBy": "String", "microsoftManagedDesktop": {
- "type": "String",
- "profile": "String"
+ "@odata.type": "microsoft.graph.microsoftManagedDesktop"
}, "onPremisesConnectionId": "String",
+ "provisioningType": "String",
"windowsSettings": { "@odata.type": "microsoft.graph.cloudPcWindowsSettings" }
v1.0 Cloudpcshareduseserviceplan https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpcshareduseserviceplan.md
+
+ Title: "cloudPcSharedUseServicePlan resource type"
+description: "Represents a shared-use service plan that can be used by up to three Cloud PCs."
+
+ms.localizationpriority: medium
++
+# cloudPcSharedUseServicePlan resource type
+
+Namespace: microsoft.graph
++
+Represents a shared-use service plan that can be used by up to three Cloud PCs.
+
+## Methods
+
+|Method|Return type|Description|
+|:|:|:|
+|[List cloudPcSharedUseServicePlans](../api/virtualendpoint-list-shareduseserviceplans.md)|[cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) collection|Get a list of the [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) objects and their properties.|
+|[Get cloudPcSharedUseServicePlan](../api/cloudpcshareduseserviceplan-get.md)|[cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md)|Read the properties and relationships of a [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) object.|
+
+## Properties
+
+| Property | Type | Description |
+|:|:-|:--|
+| displayName | String | The display name of the shared-use service plan. |
+| id | String | The unique identifier for the shared-use service plan. |
+| totalCount | Int32 | Total number of shared-use service plans purchased by the customer. |
+| usedCount | Int32 | The number of service plans that the account uses. |
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.cloudPcSharedUseServicePlan",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcSharedUseServicePlan",
+ "displayName": "String",
+ "id": "String (identifier)",
+ "usedCount": "Int32",
+ "totalCount": "Int32"
+}
+```
v1.0 Cloudpcsnapshot https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpcsnapshot.md
Inherits from [entity](../resources/entity.md).
|createdDateTime|DateTimeOffset|The date and time at which the snapshot was taken. 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`.| |id|String|The unique identifier for the snapshot of the Cloud PC device at a specific point in time. Inherited from [entity](../resources/entity.md).| |lastRestoredDateTime|DateTimeOffset|The date and time at which the snapshot was last used to restore the Cloud PC device. 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`.|
+|snapshotType| [cloudPcSnapshotType](#cloudpcsnapshottype-values) | The type of snapshot. indicates how the snapshot is to be created. Possible values are `automatic`, `manual`. Default value is `automatic`.|
|status|[cloudPcSnapshotStatus](#cloudpcsnapshotstatus-values)|The status of the Cloud PC snapshot. The possible values are: `ready`, `unknownFutureValue`.|
+|expirationDateTime|DateTimeOffset| The date and time when the snapshot expires. The time is shown in ISO 8601 format and Coordinated Universal Time (UTC) time. For example, midnight UTC on Jan 1, 2014 appears as'2014-01-01T00:00:00Z'.|
-### cloudPcSnapshotStatus values
+### cloudPcSnapshotStatus values
|Member|Description| |:|:| |ready|The snapshot is ready to restore the Cloud PC device.| |unknownFutureValue|Evolvable enumeration sentinel value. Do not use.|
+### cloudPcSnapshotType values
+
+| Member | Description |
+| -- | -- |
+| `automatic` | The snapshot is created automaticaly. |
+| `manual` | The snapshot is created manually. |
+| `unknownFutureValue` | Evolvable enumeration sentinel value. Do not use. |
+ ## Relationships None.
The following is a JSON representation of the resource.
"createdDateTime": "String (timestamp)", "id": "String (identifier)", "lastRestoredDateTime": "String (timestamp)",
- "status": "String"
+ "status": "String",
+ "snapshotType": "String",
+ "expirationDateTime": "String (timestamp)",
} ```
v1.0 Command https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/command.md
description: "Set of commands sent to a device."
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "directory-management"-+ # command resource type
v1.0 Custom Security Attributes Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/custom-security-attributes-overview.md
ms.localizationpriority: medium ms.prod: "directory-management" doc_type: conceptualPageType Previously updated : 04/01/2022 Last updated : 02/14/2023 # Overview of custom security attributes using the Microsoft Graph API (Preview)
Custom security attributes can be assigned to the following objects by using the
+ [user](/graph/api/resources/user?view=graph-rest-beta&preserve-view=true) + [servicePrincipal](/graph/api/resources/serviceprincipal?view=graph-rest-beta&preserve-view=true)
-For examples of working with custom security attributes on supported resources, see [Assign, update, or remove custom security attributes using Microsoft Graph](/graph/custom-security-attributes-examples).
+For examples of custom security attribute assignments, see [Examples: Assign, update, list, or remove custom security attribute assignments using the Microsoft Graph API](/graph/custom-security-attributes-examples).
## Limits and constraints
Using custom security attributes requires an Azure AD Premium P1 or P2 license.
## Next steps + [customSecurityAttributeDefinition resource type](/graph/api/resources/customsecurityattributedefinition)
-+ [Assign, update, or remove custom security attributes using the Microsoft Graph API](/graph/custom-security-attributes-examples)
++ [Examples: Assign, update, list, or remove custom security attribute assignments using the Microsoft Graph API](/graph/custom-security-attributes-examples) + [What are custom security attributes in Azure AD?](/azure/active-directory/fundamentals/custom-security-attributes-overview)
v1.0 Devicedetail https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/devicedetail.md
Title: "deviceDetail resource type" description: "Indicates device details associated with a device used for signing in." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: resourcePageType
v1.0 Dynamics Paymentmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/dynamics-paymentmethods.md
Title: paymentMethods resource type
-description: A payment method object in Dynamics 365 Business Central.
--
+ Title: "paymentMethods resource type"
+description: "Represents a method of payment in Dynamics 365 Business Central such as PayPal, credit card, and bank account."
+
+documentationcenter: ""
+ ms.localizationpriority: medium ms.prod: "dynamics-365-business-central" doc_type: resourcePageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a method of payment in Dynamics 365 Business Central, such as PayPal, credit card, and bank account.
+Represents a method of payment in Dynamics 365 Business Central such as PayPal, credit card, and bank account.
## Methods | Method | Return Type |Description | |:-|:-|:--|
-|[Get paymentMethods](../api/dynamics-paymentmethods-get.md) |paymentMethods|Gets a payment method object. |
-|[Post paymentMethods](../api/dynamics-create-paymentmethods.md) |paymentMethods|Creates a payment method object.|
-|[Patch paymentMethods](../api/dynamics-paymentmethods-update.md) |paymentMethods|Updates a payment method object.|
-|[Delete paymentMethods](../api/dynamics-paymentmethods-delete.md)|none |Deletes a payment method object.|
+|[Get paymentMethods](../api/dynamics-paymentmethods-get.md) |[paymentMethods](dynamics-paymentmethods.md)|Get a payment method object. |
+|[Post paymentMethods](../api/dynamics-create-paymentmethods.md) |[paymentMethods](dynamics-paymentmethods.md)|Create a payment method object.|
+|[Patch paymentMethods](../api/dynamics-paymentmethods-update.md) |[paymentMethods](dynamics-paymentmethods.md)|Update a payment method object.|
+|[Delete paymentMethods](../api/dynamics-paymentmethods-delete.md)|None |Delete a payment method object.|
## Properties | Property | Type |Description | |:-|:-|:|
-|id |GUID |The unique ID of the paymentMethods. Non-editable. |
-|code |string |Specifies the payment method code. |
-|displayName |string |Specifies the payment method display name. |
-|lastModifiedDateTime|datetime|The last datetime the payment method was modified. Read-Only.|
+|code |String |The payment method code. |
+|displayName |String |The payment method display name. |
+|id |GUID |The unique identifier of the **paymentMethods**. Non-editable.|
+|lastModifiedDateTime|Datetime|The date and time when the payment method was last modified. Read-Only.|
## Relationships
-None
+None.
## JSON representation
-Here is a JSON representation of the paymentMethods.
-
+The following is a JSON representation of the resource.
```json {
+ "code": "String",
+ "displayName": "String",
"id": "GUID",
- "code": "string",
- "displayName": "string",
- "lastModifiedDateTime": "datetime"
+ "lastModifiedDateTime": "Datetime"
}- ```
v1.0 Dynamics Taxgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/dynamics-taxgroups.md
Title: taxGroups resource type
-description: A tax group object in Dynamics 365 Business Central.
--
+ Title: "taxGroups resource type"
+description: "A tax group object in Dynamics 365 Business Central."
+
+documentationcenter: ""
+ ms.localizationpriority: medium ms.prod: "dynamics-365-business-central" doc_type: resourcePageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a taxGroups resource type in Dynamics 365 Business Central.
+Represents a [taxGroups](dynamics-taxgroups.md) object in Dynamics 365 Business Central.
## Methods | Method | Return Type |Description| |:|:--|:-|
-|[Get taxGroups](../api/dynamics-taxgroups-get.md)|taxGroups|Gets a tax group object.|
-|[Post taxGroups](../api/dynamics-create-taxgroups.md)|taxGroups|Creates a tax group object.|
-|[Patch taxGroups](../api/dynamics-taxgroups-update.md)|taxGroups|Updates a tax group object.|
-|[Delete taxGroups](../api/dynamics-taxgroups-delete.md)|none|Deletes a tax group object.|
+|[Get taxGroups](../api/dynamics-taxgroups-get.md)|[taxGroups](dynamics-taxgroups.md)|Get a tax group object.|
+|[Post taxGroups](../api/dynamics-create-taxgroups.md)|[taxGroups](dynamics-taxgroups.md)|Create a tax group object.|
+|[Patch taxGroups](../api/dynamics-taxgroups-update.md)|[taxGroups](dynamics-taxgroups.md)|Update a tax group object.|
+|[Delete taxGroups](../api/dynamics-taxgroups-delete.md)|None|Delete a tax group object.|
## Properties | Property | Type |Description| |:|:--|:-|
-|id|GUID|The unique ID of the taxGroup. Read-Only.|
-|code|string|Specifies the tax group.|
-|displayName|string|Specifies the tax group display name.|
-|taxType|string|Specifies the tax type for the group.|
-|lastModifiedDateTime|datetime|The last datetime the tax group was modified. Read-Only.|
+|code|String|Indicates the tax group.|
+|displayName|String|The display name of the tax group.|
+|id|String|The unique identifier for the tax group. Read-Only.|
+|lastModifiedDateTime|datetime|The date and time when the tax group was last modified. Read-Only.|
+|taxType|string|The tax type for the group.|
## Relationships
-None
+None.
## JSON representation
-Here is a JSON representation of the taxGroup.
+The following is a JSON representation of the resource.
```json {
- "id": "GUID",
- "code": "string",
- "displayName": "string",
- "taxType": "string",
- "lastModifiedDateTime": "datetime"
+ "code": "String",
+ "displayName": "String",
+ "id": "String (identifier)",
+ "lastModifiedDateTime": "String (timestamp)",
+ "taxType": "String"
}- ```----
v1.0 Event https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/event.md
Here is a JSON representation of the resource
- [Add custom data to resources using extensions](/graph/extensibility-overview) - [Add custom data to users using open extensions](/graph/extensibility-open-users) - [Add custom data to groups using schema extensions](/graph/extensibility-schema-groups)
+- [Bulk meetings C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-bulk-meetings/csharp)
+- [Bulk meetings Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-bulk-meetings/nodejs)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Externalconnectors Externalactivity https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/externalconnectors-externalactivity.md
ms.localizationpriority: medium
ms.prod: "search" doc_type: resourcePageType - # externalActivity resource type
v1.0 Externalconnectors Itemidresolver https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/externalconnectors-itemidresolver.md
Namespace: microsoft.graph.externalConnectors
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Defines the rules for resolving a URL to the ID of an [externalItem](microsoft.graph.externalConnectors.externalItem](externalconnectors-externalitem.md).
+Defines the rules for resolving a URL to the ID of an [externalItem](externalconnectors-externalitem.md).
Inherits from [urlToItemResolverBase](../resources/externalconnectors-urltoitemresolverbase.md).
v1.0 Externalconnectors Urltoitemresolverbase https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/externalconnectors-urltoitemresolverbase.md
ms.localizationpriority: medium
ms.prod: "search" doc_type: resourcePageType - # urlToItemResolverBase resource type
Namespace: microsoft.graph.externalConnectors
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Defines the rules for resolving a URL to the ID of an [externalItem](microsoft.graph.externalConnectors.externalItem](externalconnectors-externalitem.md).
+Defines the rules for resolving a URL to the ID of an [externalItem](externalconnectors-externalitem.md).
This is an abstract type.
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/group.md
This resource supports:
| autoSubscribeNewMembers | Boolean | Indicates if new members added to the group will be auto-subscribed to receive email notifications. You can set this property in a PATCH request for the group; do not set it in the initial POST request that creates the group. Default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`). | | classification | String | Describes a classification for the group (such as low, medium or high business impact). Valid values for this property are defined by creating a ClassificationList [setting](directorysetting.md) value, based on the [template definition](directorysettingtemplate.md).<br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `startsWith`). | | createdByAppId | String | App ID of the app used to create the group. Can be null for some groups. <br><br>Returned by default. Read-only. Supports `$filter` (`eq`, `ne`, `not`, `in`, `startsWith`). |
-| createdDateTime | DateTimeOffset | Timestamp of when the group was created. The value cannot be modified and is automatically populated when the group is created. 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 is `2014-01-01T00:00:00Z`. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`). Read-only. |
+| createdDateTime | DateTimeOffset | Timestamp of when the group was created. The value cannot be modified and is automatically populated when the group is created. 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 is `2014-01-01T00:00:00Z`. <br><br>Returned by default. Read-only. |
| deletedDateTime | DateTimeOffset | For some Azure Active Directory objects (user, group, application), if the object is deleted, it is first logically deleted, and this property is updated with the date and time when the object was deleted. Otherwise this property is null. If the object is restored, this property is updated to null. | | description | String | An optional description for the group. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `startsWith`) and `$search`. | | displayName | String | The display name for the group. Required. Maximum length is 256 characters. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values), `$search`, and `$orderBy`. |
v1.0 Identitygovernance https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/identitygovernance.md
None.
|appConsent|[appConsent](appconsentapprovalroute.md)| Container for base resources that expose the app consent request API and features. Currently exposes only the [appConsentRequests](appconsentrequest.md) resource.| |entitlementManagement|[entitlementManagement](entitlementmanagement.md)| Container for entitlement management resources, including [accessPackageCatalog](accesspackagecatalog.md), [connectedOrganization](connectedorganization.md), and [entitlementManagementSettings](entitlementmanagementsettings.md).| |termsOfUse|[termsOfUseContainer](termsofusecontainer.md)| Container for the resources that expose the terms of use API and its features, including [agreements](agreement.md) and [agreementAcceptances](agreementacceptance.md). |
-|Lifecycle Workflows|[lifecycleWorkflowsContainer](identitygovernance-lifecycleworkflowscontainer.md)| Container for Lifecycle Workflow resources, including [workflows](identitygovernance-workflow.md), [customTaskExtension](identitygovernance-customtaskextension.md), and [LifecycleManagementSettings](identitygovernance-lifecyclemanagementsettings.md|
+|lifecycleWorkflows|[microsoft.graph.identityGovernance.lifecycleWorkflowsContainer](identitygovernance-lifecycleworkflowscontainer.md)| Container for Lifecycle Workflow resources, including [workflow](identitygovernance-workflow.md), [customTaskExtension](identitygovernance-customtaskextension.md), and [lifecycleManagementSettings](identitygovernance-lifecyclemanagementsettings.md|
v1.0 Intune Enrollment Depenrollmentbaseprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-enrollment-depenrollmentbaseprofile.md
Inherits from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofi
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See hhttps://learn.microsoft.com/mem/intune/enrollment/device-enrollment for additional information.|
|supportDepartment|String|Support department information| |isMandatory|Boolean|Indicates if the profile is mandatory| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled|
v1.0 Intune Enrollment Importedappledeviceidentity https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-enrollment-importedappledeviceidentity.md
The importedAppleDeviceIdentity resource represents the imported device identity
|serialNumber|String|Device serial number| |requestedEnrollmentProfileId|String|Enrollment profile Id admin intends to apply to the device during next enrollment| |requestedEnrollmentProfileAssignmentDateTime|DateTimeOffset|The time enrollment profile was assigned to the device|
-|isSupervised|Boolean|Indicates if the Apple device is supervised. More information is at: https://support.apple.com/en-us/HT202837|
+|isSupervised|Boolean|Indicates if the Apple device is supervised. More information is at: https://support.apple.com/en-us/HT202837 |
|discoverySource|[discoverySource](../resources/intune-enrollment-discoverysource.md)|Apple device discovery source. Possible values are: `unknown`, `adminImport`, `deviceEnrollmentProgram`.| |isDeleted|Boolean|Indicates if the device is deleted from Apple Business Manager| |createdDateTime|DateTimeOffset|Created Date Time of the device|
v1.0 Intune Graph Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-graph-overview.md
The following example shows how you can determine whether an application is inst
1. Get from Azure Active Directory a list of devices registered to a user: 
- https://graph.microsoft.com/beta/users/{user}/ownedDevices 
+ `https://graph.microsoft.com/beta/users/{user}/ownedDevices`
2. Then view the list of applications for your tenant: 
- https://graph.microsoft.com/beta/deviceAppManagement/mobileApps  
+ `https://graph.microsoft.com/beta/deviceAppManagement/mobileApps`
3. Take the ID from the application and determine the installation state for the application (and therefore user):
- https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{id}/deviceStatuses/
+ `https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{id}/deviceStatuses/`
## Using Microsoft Graph permissions
v1.0 Learningprovider https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/learningprovider.md
Represents an entity that holds the details about a learning provider in Viva le
|:|:|:| |displayName|String|The display name that appears in Viva Learning. Required.| |id|String|The unique identifier for the learning provider. Required.|
-|isEnabled|Boolean|The state of the provider. Optional.|
|loginWebUrl|String|Authentication URL to access the courses for the provider. Optional.| |longLogoWebUrlForDarkTheme|String|The long logo URL for the dark mode, which needs to be a publicly accessible image. This image would be saved to the Blob storage of Viva Learning for rendering within the Viva Learning app. Required.| |longLogoWebUrlForLightTheme|String|The long logo URL for the light mode, which needs to be a publicly accessible image. This image would be saved to the Blob storage of Viva Learning for rendering within the Viva Learning app. Required.|
The following is a JSON representation of the resource.
"@odata.type": "#microsoft.graph.learningProvider", "displayName": "String", "id": "String (identifier)",
- "isEnabled": "Boolean",
"loginWebUrl": "String", "longLogoWebUrlForDarkTheme": "String", "longLogoWebUrlForLightTheme": "String",
v1.0 Mention https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/mention.md
Outlook lets the user select or enter a name to complete the @-mention. Outlook
signed-in user look up messages that mention the user, alerting the user to action items or discussions, which allows for a faster response.
+## Methods
+
+| Method | Return Type |Description|
+|:|:--|:-|
+|[Post](../api/user-sendmail.md#request-2) and send | None | Create and send mentions as part of a new message.|
+|[Post](../api/user-post-messages.md#request-2) to a new draft | [message](../resources/message.md) that contains one or more **mention** objects. | Create a draft of a new message and include one or more **mention** objects.|
+|[Get](../api/user-list-messages.md#request-2) messages mentioning me | [message](../resources/message.md) collection | Get all the messages in the signed-in user's mailbox that contain a **mention** of this user.|
+|[Get](../api/message-get.md#example-2-get-all-mentions-in-a-specific-message) a message and its mentions | [message](../resources/message.md) collection | Get a message and expand the details of each **mention** in the message.|
+|[Delete](../api/message-delete.md#request-2) a mention | None |Delete the specified mention in the specified message in the signed-in user's mailbox. |
+
+## Properties
+| Property | Type |Description|
+|:|:--|:-|
+|application | String | The name of the application where the mention is created. Optional. Not used and defaulted as null for **message**. |
+|clientReference | String | A unique identifier that represents a parent of the resource instance. Optional. Not used and defaulted as null for **message**. |
+|createdBy | [emailAddress](../resources/emailaddress.md) | The email information of the user who made the mention. |
+|createdDateTime |DateTimeOffset |The date and time that the mention is created on the client. |
+|deepLink | String | A deep web link to the context of the mention in the resource instance. Optional. Not used and defaulted as null for **message**. |
+|id | String| The unique identifier of a mention in a resource instance.|
+|mentioned | [emailAddress](../resources/emailaddress.md) | The email information of the mentioned person. Required. |
+|mentionText | String | Optional. Not used and defaulted as null for **message**. To get the mentions in a message, see the **bodyPreview** property of the message instead. |
+|serverCreatedDateTime | DateTimeOffset | The date and time that the mention is created on the server. Optional. Not used and defaulted as null for **message**. |
+
+## Relationships
+None.
## JSON representation
-Here is a JSON representation of the resource.
+The following is a JSON representation of the resource.
<!-- { "blockType": "resource",
Here is a JSON representation of the resource.
"mentionText": "string", "serverCreatedDateTime": "DateTimeOffset" }- ```
-## Properties
-| Property | Type |Description|
-|:|:--|:-|
-|application | String | The name of the application where the mention is created. Optional. Not used and defaulted as null for **message**. |
-|clientReference | String | A unique identifier that represents a parent of the resource instance. Optional. Not used and defaulted as null for **message**. |
-|createdBy | [emailAddress](../resources/emailaddress.md) | The email information of the user who made the mention. |
-|createdDateTime |DateTimeOffset |The date and time that the mention is created on the client. |
-|deepLink | String | A deep web link to the context of the mention in the resource instance. Optional. Not used and defaulted as null for **message**. |
-|id | String| The unique identifier of a mention in a resource instance.|
-|mentioned | [emailAddress](../resources/emailaddress.md) | The email information of the mentioned person. Required. |
-|mentionText | String | Optional. Not used and defaulted as null for **message**. To get the mentions in a message, see the **bodyPreview** property of the message instead. |
-|serverCreatedDateTime | DateTimeOffset | The date and time that the mention is created on the server. Optional. Not used and defaulted as null for **message**. |
-
-## Relationships
-None
--
-## Methods
-
-| Method | Return Type |Description|
-|:|:--|:-|
-|[Post](../api/user-sendmail.md#request-2) and send | None | Create and send mentions as part of a new message.|
-|[Post](../api/user-post-messages.md#request-2) to a new draft | [message](../resources/message.md) that contains one or more **mention** objects. | Create a draft of a new message and include one or more **mention** objects.|
-|[Get](../api/user-list-messages.md#request-2) messages mentioning me | [message](../resources/message.md) collection | Get all the messages in the signed-in user's mailbox that contain a **mention** of this user.|
-|[Get](../api/message-get.md#example-2-get-all-mentions-in-a-specific-message) a message and its mentions | [message](../resources/message.md) collection | Get a message and expand the details of each **mention** in the message.|
-|[Delete](../api/message-delete.md#request-2) a mention | None |Deletes the specified mention in the specified message in the signed-in user's mailbox. |
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Microsoftaccountuserconversationmember https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/microsoftaccountuserconversationmember.md
Inherits from [conversationMember](../resources/conversationmember.md).
|displayName|String|Display name of the user. Inherited from [conversationMember](../resources/conversationmember.md).| |id|String|Membership ID that represents this resource. Inherited from [entity](../resources/entity.md).| |roles|String collection|Special roles for this user. Inherited from [conversationMember](../resources/conversationmember.md).|
-|userId|String|ID of the user.|
+|userId|String|Microsoft Account ID of the user.|
|visibleHistoryStartDateTime|DateTimeOffset|The timestamp denoting how far back a conversation's history is shared with the conversation member. Inherited from [conversationMember](../resources/conversationmember.md).| ## Relationships
v1.0 Onlinemeeting https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/onlinemeeting.md
This resource supports subscribing to [change notifications](/graph/webhooks). S
| startDateTime | DateTime | The meeting start time in UTC. | | subject | String | The subject of the online meeting. | | videoTeleconferenceId | String | The video teleconferencing ID. Read-only. |
+| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether a watermark applies for different entities. |
| autoAdmittedUsers (deprecated) | String | The setting that specifies the type of participants that will automatically be allowed into the online meeting. Possible values are: `everyone`, `everyoneInSameAndFederatedCompany`, `everyoneInCompany`, `invitedUsersInCompany`, `organizer`. Read-only. | | capabilities (deprecated) | meetingCapabilities collection | The list of meeting capabilities. Possible values are: `questionAndAnswer`,`unknownFutureValue`. |
This resource supports subscribing to [change notifications](/graph/webhooks). S
"recording": "Stream", "startDateTime": "String (timestamp)", "subject": "String",
- "videoTeleconferenceId": "String"
+ "videoTeleconferenceId": "String",
+ "watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"}
} ```
v1.0 Onlinemeetingrestricted https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/onlinemeetingrestricted.md
+
+ Title: "onlineMeetingRestricted resource type"
+description: "Indicates the reason or reasons why media content from a participant is restricted."
+
+ms.localizationpriority: medium
++
+# onlineMeetingRestricted resource type
+
+Namespace: microsoft.graph
++
+Indicates the reason or reasons why media content from a participant is restricted.
+
+## Properties
+
+| Property | Type | Description |
+|:--|:--|:|
+| contentSharingDisabled | [onlineMeetingContentSharingDisabledReason](#onlinemeetingcontentsharingdisabledreason-values) | Specifies the reason why shared content from this participant is disabled. Possible values are: `watermarkProtection`, `unknownFutureValue`. |
+| videoDisabled | [onlineMeetingVideoDisabledReason](#onlinemeetingvideodisabledreason-values) | Specifies the reason why video from this participant is disabled. Possible values are: `watermarkProtection`, `unknownFutureValue`. |
+
+### onlineMeetingContentSharingDisabledReason values
+
+| Value | Description |
+|:--|:--|
+| watermarkProtection | The meeting content is marked _watermarked_ but the user joined from an unsupported client. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. |
+
+### onlineMeetingVideoDisabledReason values
+
+| Value | Description |
+|:--|:--|
+| watermarkProtection | The meeting content is marked _watermarked_ but the user joined from an unsupported client. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. |
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [],
+ "@odata.type": "microsoft.graph.onlineMeetingRestricted"
+}-->
+```json
+{
+ "contentSharingDisabled": {"@odata.type": "microsoft.graph.onlineMeetingContentSharingDisabledReason"},
+ "videoDisabled": {"@odata.type": "microsoft.graph.onlineMeetingVideoDisabledReason"}
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "onlineMeetingRestricted resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": []
+}
+-->
v1.0 Onpremisesaccidentaldeletionprevention https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/onpremisesaccidentaldeletionprevention.md
Contains the accidental deletion prevention configuration for a tenant. This con
| Property | Type | Description | | :- | :- | : | | alertThreshold | Int32 | Threshold value which triggers accidental deletion prevention. The threshold is either an absolute number of objects or a percentage number of objects. |
-| synchronizationPreventionType | onPremisesDirectorySynchronizationDeletionPreventionType | The status of the accidental deletion prevention feature. The possible values are: `disabled`, `enabledForCount`, `enabledForPercentage`. |
+| synchronizationPreventionType | onPremisesDirectorySynchronizationDeletionPreventionType | The status of the accidental deletion prevention feature. The possible values are: `disabled`, `enabledForCount`, `enabledForPercentage`, `unknownFutureValue`. |
## Relationships
v1.0 Organizationsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/organizationsettings.md
Contains settings that are applicable to the [organization](organization.md) or
| [List microsoftApplicationDataAccessSettings](../api/organizationsettings-list-microsoftapplicationdataaccess.md) | [microsoftApplicationDataAccessSettings](microsoftapplicationdataaccesssettings.md) | Get the properties of a [microsoftApplicationDataAccessSettings](microsoftapplicationdataaccesssettings.md) object that specify access from Microsoft applications to Microsoft 365 user data in an organization. | | [List peopleInsights](../api/organizationsettings-list-peopleinsights.md) | [insightsSettings](insightssettings.md) | Get the properties of an [insightsSettings](insightssettings.md) object for displaying or returning people insights in an organization. | | [List profileCardProperties](../api/organizationsettings-list-profilecardproperties.md) | [profileCardProperty](profilecardproperty.md) collection | Get a **profileCardProperty** object collection. |
+| [List pronounsSettings](../api/organizationsettings-list-pronounssettings.md)|[pronounsSettings](../resources/pronounssettings.md) resource|Get the properties of the [pronounsSettings](../resources/pronounssettings.md) resource for an organization.|
## Properties
None.
|microsoftApplicationDataAccessSettings|[microsoftApplicationDataAccessSettings](../resources/microsoftapplicationdataaccesssettings.md)| Contains the properties that are configured by an administrator to specify access from Microsoft applications to Microsoft 365 data belonging to users in an organization. [List microsoftApplicationDataAccessSettings](../api/organizationsettings-list-microsoftapplicationdataaccess.md) returns the _settings_ that specify the access. | |peopleInsights|[insightsSettings](insightssettings.md)| Contains the properties that are configured by an administrator for the visibility of a list of people [relevant and working with](/graph/people-example#including-a-person-as-relevant-or-working-with) a user in Microsoft 365. [List peopleInsights](../api/organizationsettings-list-peopleinsights.md) returns the _settings_ to display or return people insights in an organization.| |profileCardProperties|[profileCardProperty](profilecardproperty.md) collection| Contains a collection of the properties an administrator has defined as visible on the Microsoft 365 profile card. [Get organization settings](../api/organizationsettings-get.md) returns the properties configured for profile cards for the organization.|
+|pronouns|[pronounsSettings](../resources/pronounssettings.md)|Represents administrator settings that manage the support of pronouns in an organization.|
## JSON representation
v1.0 Participant https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/participant.md
Represents a participant in a call.
| mediaStreams | [mediaStream](mediastream.md) collection | The list of media streams. | | metadata | String | A blob of data provided by the participant in the roster. | | recordingInfo | [recordingInfo](recordinginfo.md) | Information on whether the participant has recording capability. |
+| restrictedExperience | [onlineMeetingRestricted](onlinemeetingrestricted.md) | Indicates the reason or reasons why media content from this participant is restricted. |
## Relationships+ None. ## JSON representation
The following is a JSON representation of the resource.
{ "id": "String (identifier)", "info": {"@odata.type": "#microsoft.graph.participantInfo"},
- "isInLobby": true,
- "isMuted": true,
+ "isInLobby": "Boolean",
+ "isMuted": "Boolean",
"mediaStreams": [ { "@odata.type": "#microsoft.graph.mediaStream" } ], "metadata": "String",
- "recordingInfo": { "@odata.type": "#microsoft.graph.recordingInfo" }
+ "recordingInfo": { "@odata.type": "#microsoft.graph.recordingInfo" },
+ "restrictedExperience": { "@odata.type": "#microsoft.graph.onlineMeetingRestricted" }
} ```
The following is a JSON representation of the resource.
"suppressions": [] } -->--
v1.0 Plannerplancontainer https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/plannerplancontainer.md
Planner currently supports the container types listed in the following table. Wh
|Type|Description|Path to the resource| |-|--|--|
-|group| Plan is contained by a [group](group.md).| https://graph.microsoft.com/beta/groups/&lt;id&gt;|
-|roster| Plan is contained by a [plannerRoster](plannerroster.md). | https://graph.microsoft.com/beta/planner/rosters/&lt;id&gt;|
+|group| Plan is contained by a [group](group.md).| `https://graph.microsoft.com/beta/groups/<id>` |
+|roster| Plan is contained by a [plannerRoster](plannerroster.md). | `https://graph.microsoft.com/beta/planner/rosters/<id>` |
|project| Plan is contained by a Project from [Microsoft Project for the web](/project-for-the-web/projectforweb-admin-home). | Microsoft Project currently doesn't have a resource path on Microsoft Graph. Project details and members can be managed from [Microsoft Project](https://project.microsoft.com). | ## Properties
v1.0 Pronounssettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/pronounssettings.md
+
+ Title: "pronounsSettings resource type"
+description: "Represents a setting to control the availability of pronouns in the tenant"
+
+ms.localizationpriority: medium
++
+# pronounsSettings resource type
+
+Namespace: microsoft.graph
++
+Represents the _settings_ that manage the support of pronouns in an organization. By default, pronouns are **disabled**. If enabled, users can optionally add or update their pronouns.
+
+For more information about enabling pronouns support, see [Manage pronouns settings for an organization using the Microsoft Graph API](/graph/pronouns-configure-pronouns-availability.md)
+
+Inherits from [entity](../resources/entity.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List pronounsSettings](../api/organizationsettings-list-pronounssettings.md)|[pronounsSettings](../resources/pronounssettings.md)|Get the properties from the [pronounsSettings](../resources/pronounssettings.md) resource for an organization.|
+|[Update pronounsSettings](../api/pronounssettings-update.md)|[pronounsSettings](../resources/pronounssettings.md)|Update the properties of a [pronounsSettings](../resources/pronounssettings.md) resource for an organization.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|isEnabledInOrganization|Boolean| `true` to enable pronouns in the organization, `false` otherwise. The default is `false`, and pronouns are disabled.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.pronounsSettings",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "isEnabledInOrganization": "Boolean"
+}
+```
+
v1.0 Recommendation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/recommendation.md
Inherits from [recommendationBase](../resources/recommendationbase.md).
|maxScore|Double|The maximum number of points attainable. Only applies to [recommendations](../resources/recommendation.md) with **category** set to `identitySecureScore`. Inherited from [recommendationBase](../resources/recommendationbase.md).| |postponeUntilDateTime|DateTimeOffset|The future date and time when the **status** of a postponed [recommendation](../resources/recommendation.md) will be `active` again. Inherited from [recommendationBase](../resources/recommendationbase.md).| |priority|recommendationPriority|Indicates the time sensitivity for a [recommendation](../resources/recommendation.md) to be completed. Microsoft auto assigns this value. The possible values are: `low`, `medium`, `high`. Inherited from [recommendationBase](../resources/recommendationbase.md). Read-only. <br><br> Supports `$filter`(`eq`).|
-|recommendationType|recommendationType|Friendly shortname to identify the [recommendation](../resources/recommendation.md). The possible values are: `adfsAppsMigration`, `enableDesktopSSO`, `enablePHS`, `enableProvisioning`, `switchFromPerUserMFA`, `tenantMFA`, `thirdPartyApps`, `turnOffPerUserMFA`, `useAuthenticatorApp`, `useMyApps`, `staleApps`, `staleAppCreds`, `applicationCredentialExpiry`, `servicePrincipalKeyExpiry`, `adminMFAV2`, `blockLegacyAuthentication`, `integratedApps`, `mfaRegistrationV2`, `pwagePolicyNew`, `passwordHashSync`, `oneAdmin`, `roleOverlap`, `selfServicePasswordReset`, `signinRiskPolicy`, `userRiskPolicy`, `verifyAppPublisher`, `privateLinkForAAD`, `appRoleAssignmentsGroups`, `appRoleAssignmentsUsers`, `managedIdentity`, `overprivilegedApps`, `unknownFutureValue`. Inherited from [recommendationBase](../resources/recommendationbase.md). <br><br> Supports `$filter`(`eq`).|
+|recommendationType|recommendationType|Friendly shortname to identify the [recommendation](../resources/recommendation.md). The possible values are: `adfsAppsMigration`, `enableDesktopSSO`, `enablePHS`, `enableProvisioning`, `switchFromPerUserMFA`, `tenantMFA`, `thirdPartyApps`, `turnOffPerUserMFA`, `useAuthenticatorApp`, `useMyApps`, `staleApps`, `staleAppCreds`, `applicationCredentialExpiry`, `servicePrincipalKeyExpiry`, `adminMFAV2`, `blockLegacyAuthentication`, `integratedApps`, `mfaRegistrationV2`, `pwagePolicyNew`, `passwordHashSync`, `oneAdmin`, `roleOverlap`, `selfServicePasswordReset`, `signinRiskPolicy`, `userRiskPolicy`, `verifyAppPublisher`, `privateLinkForAAD`, `appRoleAssignmentsGroups`, `appRoleAssignmentsUsers`, `managedIdentity`, `overprivilegedApps`, `unknownFutureValue`. Inherited from [recommendationBase](../resources/recommendationbase.md). <br><br> Currently, only eight types are available. For more information, see [Types of recommendations](recommendations-api-overview.md#types-of-recommendations). Supports `$filter`(`eq`).|
|remediationImpact|String|Description of the impact on users of the remediation. Only applies to [recommendations](../resources/recommendation.md) with **category** set to `identitySecureScore`. Inherited from [recommendationBase](../resources/recommendationbase.md).| |status|recommendationStatus| Indicates the status of the [recommendation](../resources/recommendation.md) based on user or system action. The possible values are: `active`, `completedBySystem`, `completedByUser`, `dismissed`, `postponed`, `unknownFutureValue`. By default, a recommendation's **status** is set to `active` when the recommendation is first generated. **Status** is set to `completedBySystem` when our service detects that a recommendation which was previously active no longer applies. Inherited from [recommendationBase](../resources/recommendationbase.md). <br><br> Supports `$filter`(`eq`).|
v1.0 Recommendations Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/recommendations-api-overview.md
+
+ Title: "Use the Azure AD recommendations API to implement Azure AD best practices for your tenant"
+description: "Azure Active Directory (Azure AD) recommendations are personalized and actionable insights for you to implement Azure AD best practices in your tenant."
+
+ms.localizationpriority: medium
Last updated : 02/10/2023++
+# Use the Azure AD recommendations API to implement Azure AD best practices for your tenant
+
+Azure Active Directory (Azure AD) recommendations are personalized and actionable insights for you to implement Azure AD best practices in your tenant. The Azure AD recommendation service runs daily to check your tenant against predefined conditions for every recommendation. If the service detects that a recommendation applies to your tenant, the corresponding recommendation object is generated and its status is set to active.
+
+Use the recommendations API in Microsoft Graph to identify and track the insights, assess and apply the guidance provided for implementing the best practices, and keep your tenant healthy, secure and optimized.
+
+## Manage recommendations
+
+Azure AD recommendations are made up of two building blocks: **recommendations** and **the Azure AD resources they apply to**.
+
+A single recommendation can apply to one or more Azure AD resource instances. For example, a recommendation relating to expiring application credentials will reference all apps in your tenant that have expiring application credentials.
+
+For each recommendation, you have the following data:
+
+- The type of recommendation. Eight types are currently supported. For more information about types of recommendations, see [Types of recommendations](#types-of-recommendations).
+- The Azure AD resources to which the recommendation applies. These include users, groups, and applications.
+- The recommended action plan to address the recommendation.
+- Where applicable, when Azure AD recommends the recommendation to have been completed before it impacts the associated service.
+- The impact of the recommendation, which can be tenant-wide or resource-specific.
+- A Microsoft-assigned priority ranking for the recommendation.
+- The status of the recommendation such as whether itΓÇÖs still active or has been completed, dismissed, or postponed to a future date.
+
+### Types of recommendations
+
+Eight types of recommendations are currently available in Azure AD recommendations. These recommendations are identified in a **recommendationType** property thatΓÇÖs part of the **recommendation** object in Microsoft Graph.
+
+The following table lists the recommendation types that are available, and maps the Microsoft Graph values to the user-friendly names that are used on the Azure portal.
+
+| recommendationType | Friendly name in the Azure portal | Comments |
+|--|-||
+| adfsAppsMigration | Migrate your eligible applications from AD FS to Azure AD for more security, productivity and automation | For more information, see [Migrate apps from ADFS to Azure AD](/azure/active-directory/reports-monitoring/recommendation-migrate-apps-from-adfs-to-azure-ad) |
+| switchFromPerUserMFA | Convert per-user MFA to Conditional Access MFA | For more information, see [Convert per-user MFA to Conditional Access MFA](/azure/active-directory/reports-monitoring/recommendation-turn-off-per-user-mfa) |
+| tenantMFA | Minimize MFA prompts for your users signing in from known devices | For more information, see [Minimize MFA prompts from known devices](/azure/active-directory/reports-monitoring/recommendation-mfa-from-known-devices) |
+| useAuthenticatorApp | Migrate eligible users from SMS and voice call to Microsoft Authenticator App for a better MFA user experience | For more information, see [Migrate to Microsoft authenticator](/azure/active-directory/reports-monitoring/recommendation-migrate-to-authenticator) |
+| staleApps | Remove unused applications | For more information, see [Remove unused applications](/azure/active-directory/reports-monitoring/recommendation-remove-unused-apps) |
+| staleAppCreds | Remove unused credentials from applications | For more information, see [Remove unused credentials from apps](/azure/active-directory/reports-monitoring/recommendation-remove-unused-credential-from-apps) |
+| applicationCredentialExpiry | Renew expiring application credentials | For more information, see [Renew expiring application credentials](/azure/active-directory/reports-monitoring/recommendation-remove-unused-credential-from-apps) |
+| servicePrincipalKeyExpiry | Renew expiring serivce principal credentials | For more information, see [Renew expiring service principal credentials](/azure/active-directory/reports-monitoring/recommendation-renew-expiring-service-principal-credential) |
+
+## API scenarios
+
+You manage recommendations through the [recommendation resource type](recommendation.md) and its associated methods. This resource type exposes the **impactedResources** relationship that you use to query the Azure AD resource to which the recommendations apply.
+
+The following are some of the most popular requests for working with the Microsoft Graph recommendations API:
+
+| Scenarios | API |
+|||
+| Retrieve all recommendations and their associated data, including the impacted resources. | [List recommendations](../api/directory-list-recommendation.md) |
+| Retrieve a recommendation and its associated data, including the impacted resources. | [Get recommendation](../api/recommendation-get.md) |
+| Act on a recommendation | [Dismiss](../api/recommendation-dismiss.md) <br/> [Postpone](../api/recommendation-postpone.md) <br/> [Complete](../api/recommendation-complete.md) <br/> [Reactivate](../api/recommendation-reactivate.md) |
+| Retrieve details of all impacted resources for a recommendation. | [List impactedResources](../api/recommendation-list-impactedresources.md) |
+| Retrieve details of an impacted resource for a recommendation. | [Get impactedResource](../api/impactedresource-get.md) |
+| Act on a recommendation for an impacted resource | [Dismiss](../api/impactedresource-dismiss.md) <br/> [Postpone](../api/impactedresource-postpone.md) <br/> [Complete](../api/impactedresource-complete.md) <br/> [Reactivate](../api/impactedresource-reactivate.md) |
+
+## License requirements
+
+The various recommendations have different license requirements. For more information about licenses for each type of recommendation, see [Azure AD recommendations: Roles and licenses](/azure/active-directory/reports-monitoring/overview-recommendations#roles-and-licenses).
+
+## See also
+
+- [What is Azure Active Directory recommendations (preview)]( /azure/active-directory/reports-monitoring/overview-recommendations)
v1.0 Serviceprincipal https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/serviceprincipal.md
This resource supports using [delta query](/graph/delta-query-overview) to track
|appOwnerOrganizationId|Guid|Contains the tenant id where the application is registered. This is applicable only to service principals backed by applications.Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`).| |appRoleAssignmentRequired|Boolean|Specifies whether users or other service principals need to be granted an app role assignment for this service principal before users can sign in or apps can get tokens. The default value is `false`. Not nullable. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`). | |appRoles|[appRole](approle.md) collection|The roles exposed by the application which this service principal represents. For more information see the **appRoles** property definition on the [application](application.md) entity. Not nullable. |
-|customSecurityAttributes|[customSecurityAttributeValue](../resources/customsecurityattributevalue.md)|An open complex type that holds the value of a custom security attribute that is assigned to a directory object. Nullable. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `startsWith`).|
+|customSecurityAttributes|[customSecurityAttributeValue](../resources/customsecurityattributevalue.md)|An open complex type that holds the value of a custom security attribute that is assigned to a directory object. Nullable. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `startsWith`). Filter value is case sensitive.|
| deletedDateTime | DateTimeOffset | The date and time the service principal was deleted. Read-only. | | description | String | Free text field to provide an internal end-user facing description of the service principal. End-user portals such [MyApps](/azure/active-directory/user-help/my-apps-portal-end-user-access) will display the application description in this field. The maximum allowed size is 1024 characters. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `startsWith`) and `$search`.| | disabledByMicrosoftStatus | String | Specifies whether Microsoft has disabled the registered application. Possible values are: `null` (default value), `NotDisabled`, and `DisabledDueToViolationOfServicesAgreement` (reasons may include suspicious, abusive, or malicious activity, or a violation of the Microsoft Services Agreement). <br><br> Supports `$filter` (`eq`, `ne`, `not`). |
v1.0 Shift https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/shift.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-A unit of scheduled work in a [schedule](schedule.md).
+A unit of scheduled work in a [schedule](schedule.md).
+
+The duration of a shift cannot be less than 1 minute or longer than 24 hours.
## Methods
v1.0 Skypeforbusinessuserconversationmember https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/skypeforbusinessuserconversationmember.md
Inherits from [conversationMember](../resources/conversationmember.md).
|id|String|Membership ID that represents this resource. Inherited from [entity](../resources/entity.md).| |roles|String collection|Special roles for this user. Inherited from [conversationMember](../resources/conversationmember.md).| |tenantId|String|ID of the tenant that the user belongs to.|
-|userId|String|ID of the user.|
+|userId|String|Azure Active Directory ID of the user.|
|visibleHistoryStartDateTime|DateTimeOffset|The timestamp denoting how far back a conversation's history is shared with the conversation member. Inherited from [conversationMember](../resources/conversationmember.md).| ## Relationships
v1.0 Subscription https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/subscription.md
For the possible resource path values for each supported resource, see [Use the
|||| | applicationId | String | Optional. Identifier of the application used to create the subscription. Read-only. | | changeType | String | Required. Indicates the type of change in the subscribed resource that will raise a change notification. The supported values are: `created`, `updated`, `deleted`. Multiple values can be combined using a comma-separated list. <br><br>**Note:** <li> Drive root item and list change notifications support only the `updated` changeType. <li>[User](../resources/user.md) and [group](../resources/user.md) change notifications support `updated` and `deleted` changeType. Use `updated` to receive notifications when user or group is created, updated or soft deleted. Use `deleted` to receive notifications when user or group is permanently deleted. |
-| clientState | String | Optional. Specifies the value of the **clientState** property sent by the service in each change notification. The maximum length is 255 characters. The client can check that the change notification came from the service by comparing the value of the **clientState** property sent with the subscription with the value of the **clientState** property received with each change notification. |
+| clientState | String | Required. Specifies the value of the **clientState** property sent by the service in each change notification. The maximum length is 255 characters. The client can check that the change notification came from the service by comparing the value of the **clientState** property sent with the subscription with the value of the **clientState** property received with each change notification. |
| creatorId | String | Optional. Identifier of the user or service principal that created the subscription. If the app used delegated permissions to create the subscription, this field contains the ID of the signed-in user the app called on behalf of. If the app used application permissions, this field contains the ID of the service principal corresponding to the app. Read-only. | | encryptionCertificate | String | Optional. A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Optional but required when **includeResourceData** is `true`. | | encryptionCertificateId | String | Optional. A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Required when **includeResourceData** is `true`. |
v1.0 Teamsapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/teamsapp.md
Users can see these apps in the Microsoft Teams Store, and these apps can be ins
- [teamsTab](../resources/teamstab.md) - [App catalog sample (C#)](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/graph-appcatalog-lifecycle/csharp) - [App catalog sample (Node.JS)](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/graph-appcatalog-lifecycle/nodejs)
+- [Teams app catalog lifecycle C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-appcatalog-lifecycle/csharp)
+- [Teams app catalog lifecycle Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-appcatalog-lifecycle/nodejs)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Teamsappinstallation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/teamsappinstallation.md
The following is a JSON representation of the resource.
- [teamsAppDefinition](teamsappdefinition.md) - [teamsTab](../resources/teamstab.md) - [userScopeTeamsAppInstallation](../resources/userscopeteamsappinstallation.md)
+- [Teams app installation lifecycle C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-app-installation-lifecycle/csharp)
+- [Teams app installation lifecycle Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-app-installation-lifecycle/nodejs)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Teamsappsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/teamsappsettings.md
Inherits from [entity](../resources/entity.md).
## Properties |Property|Type|Description| |:|:|:|
+|allowUserRequestsForAppAccess|Boolean|Indicates whether Teams users are allowed to request admins access to certain Teams apps.|
|isChatResourceSpecificConsentEnabled|Boolean|Indicates whether resource-specific consent for chats/meetings has been enabled for the tenant. If true, Teams apps that are allowed in the tenant and require resource-specific permissions can be installed inside chats and meetings. If false, the installation of any Teams app that requires resource-specific permissions in a chat or a meeting will be blocked.| ## Relationships
The following is a JSON representation of the resource.
{ "@odata.type": "#microsoft.graph.teamsAppSettings", "id": "String (identifier)",
+ "allowUserRequestsForAppAccess": "Boolean",
"isChatResourceSpecificConsentEnabled": "Boolean" } ```
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/user.md
This resource supports:
| country | String | The country/region in which the user is located; for example, `US` or `UK`. Maximum length is 128 characters. <br><br>Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values). | | createdDateTime | DateTimeOffset | The date and time the user was created, in ISO 8601 format and in UTC time. The value cannot be modified and is automatically populated when the entity is created. Nullable. For on-premises users, the value represents when they were first created in Azure AD. Property is `null` for some users created before June 2018 and on-premises users that were synced to Azure AD before June 2018. Read-only. <br><br>Supports `$filter` (`eq`, `ne`, `not` , `ge`, `le`, `in`). | | creationType | String | Indicates whether the user account was created through one of the following methods: <br/> <ul><li>As a regular school or work account (`null`). <li>As an external account (`Invitation`). <li>As a local account for an Azure Active Directory B2C tenant (`LocalAccount`). <li>Through self-service sign-up by an internal user using email verification (`EmailVerified`). <li>Through self-service sign-up by an external user signing up through a link that is part of a user flow (`SelfServiceSignUp`). </ul> <br>Read-only.<br>Supports `$filter` (`eq`, `ne`, `not`, and `in`). |
-|customSecurityAttributes|[customSecurityAttributeValue](../resources/customsecurityattributevalue.md)|An open complex type that holds the value of a custom security attribute that is assigned to a directory object. Nullable. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `startsWith`).|
+|customSecurityAttributes|[customSecurityAttributeValue](../resources/customsecurityattributevalue.md)|An open complex type that holds the value of a custom security attribute that is assigned to a directory object. Nullable. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `startsWith`). Filter value is case sensitive.|
| deletedDateTime | DateTimeOffset | The date and time the user was deleted. <br><br>Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, and `in`). | | department | String | The name for the department in which the user works. Maximum length is 64 characters.<br><br>Supports `$filter` (`eq`, `ne`, `not` , `ge`, `le`, `in`, and `eq` on `null` values). | | displayName | String | The name displayed in the address book for the user. This value is usually the combination of the user's first name, middle initial, and last name. This property is required when a user is created and it cannot be cleared during updates. Maximum length is 256 characters. <br><br>Supports `$filter` (`eq`, `ne`, `not` , `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values), `$orderBy`, and `$search`.|
v1.0 Users https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/users.md
The following table lists the sensitive actions on user objects. All users can r
| Update user principal name | userPrincipalName | | Delete or restore users | Not applicable |
-### Who can reset passwords?
+### Who can reset passwords
-In the following table, the columns list the roles that can reset passwords. The rows list the roles for which their password can be reset.
+In the following table, the columns list the roles that can reset passwords and invalidate refresh tokens. The rows list the roles for which their password can be reset.
The following table is for roles assigned at the scope of a tenant. For roles assigned at the scope of an administrative unit, [further restrictions apply](/azure/active-directory/roles/admin-units-assign-roles#roles-that-can-be-assigned-with-administrative-unit-scope).
User<br/>(no admin role) | :heavy_check_mark: | :heavy_check_mark: | :heavy_chec
User<br/>(no admin role, but member or owner of a role-assignable group) | &nbsp; | &nbsp; | &nbsp; | &nbsp; | :heavy_check_mark: | :heavy_check_mark: User Admin | &nbsp; | &nbsp; | &nbsp; | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: Usage Summary Reports Reader | &nbsp; | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:
+All custom roles | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:
\* A Global Administrator cannot remove their own Global Administrator assignment. This is to prevent a situation where an organization has 0 Global Administrators. > [!NOTE]
-> The ability to reset a password includes the ability to update the following sensitive attributes required for [self-service password reset](/azure/active-directory/authentication/concept-sspr-howitworks):
+> The ability to reset a password includes the ability to update the following sensitive properties required for [self-service password reset](/azure/active-directory/authentication/concept-sspr-howitworks):
> - businessPhones > - mobilePhone > - otherMails
-### Who can update sensitive attributes?
+### Who can perform sensitive actions
-Some administrators can update the following sensitive attributes for some users. All users can read these sensitive attributes.
+Some administrators can perform the following sensitive actions for some users. All users can read the sensitive properties.
-- accountEnabled-- businessPhones-- mobilePhone-- onPremisesImmutableId-- otherMails-- passwordProfile-- userPrincipalName
+| Sensitive action | Sensitive property name |
+| | |
+| Disable or enable users | `accountEnabled` |
+| Update business phone | `businessPhones` |
+| Update mobile phone | `mobilePhone` |
+| Update on-premises immutable ID | `onPremisesImmutableId` |
+| Update other emails | `otherMails` |
+| Update password profile | `passwordProfile` |
+| Update user principal name | `userPrincipalName` |
+| Delete or restore users | Not applicable |
-In the following table, the columns list the roles that can update the sensitive attributes. The rows list the roles for which their sensitive attributes can be updated.
+In the following table, the columns list the roles that can perform sensitive actions. The rows list the roles for which the sensitive action can be performed upon.
The following table is for roles assigned at the scope of a tenant. For roles assigned at the scope of an administrative unit, [further restrictions apply](/azure/active-directory/roles/admin-units-assign-roles#roles-that-can-be-assigned-with-administrative-unit-scope).
-Role that sensitive attributes can be updated | Auth Admin | User Admin | Privileged Auth Admin | Global Admin
+Role that sensitive action can be performed upon | Auth Admin | User Admin | Privileged Auth Admin | Global Admin
| | | | Auth Admin | :heavy_check_mark: | &nbsp; | :heavy_check_mark: | :heavy_check_mark: Directory Readers | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:
User<br/>(no admin role) | :heavy_check_mark: | :heavy_check_mark: | :heavy_chec
User<br/>(no admin role, but member or owner of a role-assignable group) | &nbsp; | &nbsp; | :heavy_check_mark: | :heavy_check_mark: User Admin | &nbsp; | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: Usage Summary Reports Reader | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:
+All custom roles | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:
+ ## User and group search limitations for guest users in organizations
v1.0 Virtualendpoint https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/virtualendpoint.md
Use the Cloud PC API to provision and manage virtual desktops for employees in a
|[List auditEvents](../api/virtualendpoint-list-auditevents.md)|[cloudPcAuditEvent](../resources/cloudpcauditevent.md) collection|List properties and relationships of the [cloudPcAuditEvent](../resources/cloudpcauditevent.md) objects.| |[List supportedRegions](../api/virtualendpoint-list-supportedregions.md)|[cloudPcSupportedRegion](../resources/cloudpcsupportedregion.md) collection|List properties and relationships of the [cloudPcSupportedRegion](../resources/cloudpcsupportedregion.md) objects.| |[List servicePlans](../api/virtualendpoint-list-serviceplans.md)|[cloudPcServicePlan](../resources/cloudpcserviceplan.md) collection|List properties and relationships of the [cloudPcServicePlan](../resources/cloudpcserviceplan.md) objects.|
+|[List sharedUseServicePlans](../api/virtualendpoint-list-shareduseserviceplans.md)|[cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) collection|List properties and relationships of the [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) objects.|
|[List snapshots](../api/virtualendpoint-list-snapshots.md)|[cloudPcSnapshot](../resources/cloudpcsnapshot.md) collection|Get a list of [cloudPcSnapshot](../resources/cloudpcsnapshot.md) objects and their properties.| |[List externalPartnerSettings](../api/virtualendpoint-list-externalpartnersettings.md)|[cloudPcExternalPartnerSetting](../resources/cloudpcexternalpartnersetting.md) collection|Get a list of the [cloudPcExternalPartnerSetting](../resources/cloudpcexternalpartnersetting.md) objects and their properties.| |[Create cloudPcExternalPartnerSetting](../api/virtualendpoint-post-externalpartnersettings.md)|[cloudPcExternalPartnerSetting](../resources/cloudpcexternalpartnersetting.md)|Create a new [cloudPcExternalPartnerSetting](../resources/cloudpcexternalpartnersetting.md) object.|
Use the Cloud PC API to provision and manage virtual desktops for employees in a
|provisioningPolicies|[cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) collection|Cloud PC provisioning policy.| |reports|[cloudPcReports](../resources/cloudpcreports.md)|Cloud PC related reports.| |servicePlans|[cloudPcServicePlan](../resources/cloudpcserviceplan.md) collection|Cloud PC service plans.|
+|sharedUseServicePlans|[cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) collection|Cloud PC shared-use service plans.|
|snapshots|[cloudPcSnapshot](../resources/cloudpcsnapshot.md) collection|Cloud PC snapshots.| |supportedRegions|[cloudPcSupportedRegion](../resources/cloudpcsupportedregion.md) collection|Cloud PC supported regions.| |userSettings|[cloudPcUserSetting](../resources/cloudpcusersetting.md) collection|Cloud PC user settings. |
v1.0 Viva Learning Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/viva-learning-api-overview.md
With the appropriate delegated or application [employee learning permissions](/g
## Use cases for the employee learning API in Microsoft Graph Use the employee learning APIs to do the following: - [Register a provider with Viva Learning](../api/employeeexperience-post-learningproviders.md), provide a display name, square logo that is displayed on a learning content card, and a long logo that is displayed in the **Details** page, which is required for the provider content to show up in Viva Learning. The returned registration ID can be used to make the subsequent calls for content ingestion.-- Enable or disable a registration and update the display name and logo URLs for a provider.ΓÇ»
+- Update the display name and logo URLs for a provider.ΓÇ»
- [Get the details about a provider](../api/learningprovider-get.md) in Viva Learning for a specific **registrationId**.ΓÇ» - [Get the list of provider registrations](../api/employeeexperience-list-learningproviders.md) in Viva Learning for a tenant. - [Delete a registration](../api/employeeexperience-delete-learningproviders.md) of a provider in Viva Learning.
v1.0 Watermarkprotectionvalues https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/watermarkprotectionvalues.md
+
+ Title: "watermarkProtectionValues resource type"
+description: "Represents the reasons for a participant's restricted media experience."
+
+ms.localizationpriority: medium
++
+# watermarkProtectionValues resource type
+
+Namespace: microsoft.graph
++
+Represents the reasons for a participant's restricted media experience.
+
+## Properties
+
+| Property | Type | Description |
+|:|:--|:|
+| isEnabledForContentSharing | Boolean | Indicates whether to apply a watermark to any shared content. |
+| isEnabledForVideo | Boolean | Indicates whether to apply a watermark to everyone's video feed. |
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.watermarkProtectionValues"
+}-->
+```json
+{
+ "@odata.type": "#microsoft.graph.watermarkProtectionValues",
+ "isEnabledForContentSharing": "Boolean",
+ "isEnabledForVideo": "Boolean"
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "watermarkProtectionValues resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": []
+}
+-->
v1.0 Webhooks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/webhooks.md
In general, subscription operations require read permission to the resource. For
- [subscription resource type](subscription.md) - [Training module: Use change notifications and track changes with Microsoft Graph](/training/modules/msgraph-changenotifications-trackchanges) - [Lifecycle notifications](/graph/webhooks-lifecycle)-
+- [Change notifications C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-change-notification/csharp)
+- [Change notifications Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-change-notification/nodejs)
<!-- Links --> [chat]: ./chat.md
v1.0 Workbooknameditem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/workbooknameditem.md
Title: "workbookNamedItem resource type"
-description: "Represents a defined name for a range of cells or value. Names can be primitive named objects (as seen in the type below), range object, reference to a range. This object can be used to obtain range object associated with names."
+description: "Represents a defined name for a range of cells or value."
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "excel"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a defined name for a range of cells or value. Names can be primitive named objects (as seen in the type below), range object, reference to a range. This object can be used to obtain range object associated with names.
+Represents a defined name for a range of cells or value. Names can be primitive named objects (as seen in the following type), range object, reference to a range. This object can be used to obtain range object associated with names.
## Methods | Method | Return Type |Description| |:|:--|:-|
-|[Add](../api/nameditem-add.md)|[workbookNamedItem](workbooknameditem.md)|Adds a new name to the collection of the given scope.|
-|[AddFormulaLocal](../api/nameditem-addformulalocal.md)|[workbookNamedItem](workbooknameditem.md)|Adds a new name to the collection of the given scope using the user's locale for the formula.|
-|[Get NamedItem](../api/nameditem-get.md) | [workbookNamedItem](workbooknameditem.md) |Read properties and relationships of namedItem object.|
-|[Update](../api/nameditem-update.md) | [workbookNamedItem](workbooknameditem.md) |Update NamedItem object. |
-|[Range](../api/nameditem-range.md)|[workbookRange](workbookrange.md)|Returns the range object that is associated with the name. Throws an exception if the named item's type is not a range.|
-|[List](../api/nameditem-list.md) | [workbookNamedItem](workbooknameditem.md) collection |Get namedItem object collection. |
+|[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.|
+|[Get NamedItem](../api/nameditem-get.md) | [workbookNamedItem](workbooknameditem.md) |Read properties and relationships of **namedItem** object.|
+|[Update](../api/nameditem-update.md) | [workbookNamedItem](workbooknameditem.md) |Update a **namedItem** object. |
+|[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. | ## Properties | Property | Type |Description| |:|:--|:-|
-|name|string|The name of the object. Read-only.|
-|comment|string|Represents the comment associated with this name.|
-|scope|string|Indicates whether the name is scoped to the workbook or to a specific worksheet. Read-only.|
-|type|string|Indicates what type of reference is associated with the name. Possible values are: `String`, `Integer`, `Double`, `Boolean`, `Range`. Read-only.|
-|value|string|Represents the formula that the name is defined to refer to. E.g. =Sheet14!$B$2:$H$12, =4.75, etc. Read-only.|
-|visible|boolean|Specifies whether the object is visible or not.|
+|comment|String|Represents the comment associated with this name.|
+|name|String|The name of the object. Read-only.|
+|scope|String|Indicates whether the name is scoped to the workbook or to a specific worksheet. Read-only.|
+|type|String|Indicates what type of reference is associated with the name. Possible values are: `String`, `Integer`, `Double`, `Boolean`, `Range`. Read-only.|
+|value|String|Represents the formula that the name is defined to refer to. For example, `=Sheet14!$B$2:$H$12` and `=4.75`. Read-only.|
+|visible|Boolean|Specifies whether the object is visible or not.|
## Relationships | Relationship | Type |Description|
Represents a defined name for a range of cells or value. Names can be primitive
## JSON representation
-Here is a JSON representation of the resource.
+The following is a JSON representation of the resource.
<!-- { "blockType": "resource",
Here is a JSON representation of the resource.
```json {
- "name": "string",
- "comment": "string",
- "scope": "string",
- "type": "string",
- "value": "string",
- "visible": true
-
+ "comment": "String",
+ "name": "String",
+ "scope": "String",
+ "type": "String",
+ "value": "String",
+ "visible": "Boolean"
}- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
Here is a JSON representation of the resource.
"suppressions": [] } -->--
v1.0 Accessreviewset List Definitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/accessreviewset-list-definitions.md
This method supports the `$select`, `$top`, `$skip`,`$orderBy`, and `$filter` OD
The default page size for this API is 100 **accessReviewScheduleDefinition** objects. To improve efficiency and avoid timeouts due to large result sets, apply pagination using the `$skip` and `$top` query parameters. For more information, see [Paging Microsoft Graph data in your app](/graph/paging). ### Use the $filter query parameter
-The `$filter` query parameter with the `contains` operator is supported on the **scope** property of accessReviewScheduleDefinition. Use the following format for the request:
-```http
-GET /identityGovernance/accessReviews/definitions?$filter=contains(scope/microsoft.graph.accessReviewQueryScope/query, '{object}')
-```
-
-The value of `{object}` can be one of the following:
-
-|Value|Description|
-|: |: |
-|`/groups` |List every accessReviewScheduleDefinition on individual groups (excludes definitions scoped to all Microsoft 365 groups with guest users).|
-|`/groups/{group id}` |List every accessReviewScheduleDefinition on a specific group (excludes definitions scoped to all Microsoft 365 groups with guest users).|
-|`./members` |List every accessReviewScheduleDefinition scoped to all Microsoft 365 groups with guest users.|
-|`accessPackageAssignments` |List every accessReviewScheduleDefinition on an access package.|
-|`roleAssignmentScheduleInstances` |List every accessReviewScheduleDefinition for service principals assigned to a privileged role.|
-
-The `$filter` query parameter is not supported on **accessReviewInactiveUserQueryScope** or **principalResourceMembershipScope**.
## Request headers |Name|Description|
v1.0 Accessreviewset Post Historydefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/accessreviewset-post-historydefinitions.md
The following table shows the required properties used to create an [accessRevie
The **scopes** property of [accessReviewHistoryDefinition](../resources/accessreviewhistorydefinition.md) is based on **accessReviewQueryScope**, a resource that allows you to configure different resources in it's **query** property. These resources then represent the scope of the history definition and dictate the type of review history data that is included in the downloadable CSV file which is generated when the history definition's [accessReviewHistoryInstances](../resources/accessreviewhistoryinstance.md) are created.
-Use the following format for the **query** property:
-
-```http
-/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, '{object}')
-```
-
-The value of `{object}` is one of the resources that can be configured in an **accessReviewScheduleDefinition**. For example, the following includes every accessReviewScheduleDefinition review result on individual groups (and excludes definitions scoped to all Microsoft 365 groups with guest users).
-
-```http
-/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, '/groups')
-```
-
-For more supported values, see Use the [$filter query parameter on accessReviewScheduleDefinition](accessreviewset-list-definitions.md#use-the-filter-query-parameter).
## Response
v1.0 Administrativeunit Delete Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/administrativeunit-delete-scopedrolemembers.md
DELETE https://graph.microsoft.com/v1.0/directory/administrativeUnits/{id}/scope
[!INCLUDE [sample-code](../includes/snippets/php/delete-scopedrolemember-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Administrativeunit Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/administrativeunit-delete.md
DELETE https://graph.microsoft.com/v1.0/directory/administrativeUnits/{id}
[!INCLUDE [sample-code](../includes/snippets/php/delete-administrativeunit-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Administrativeunit Get Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/administrativeunit-get-scopedrolemembers.md
GET https://graph.microsoft.com/v1.0/directory/administrativeUnits/{id}/scopedRo
[!INCLUDE [sample-code](../includes/snippets/php/get-scopedrolemember-1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Administrativeunit List Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/administrativeunit-list-scopedrolemembers.md
GET https://graph.microsoft.com/v1.0/directory/administrativeUnits/8a07f5a8-edc9
[!INCLUDE [sample-code](../includes/snippets/php/get-scopedrolemember-2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Administrativeunit Post Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/administrativeunit-post-scopedrolemembers.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-scopedrolemembership-from-administrativeunit-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- In the request body, supply a JSON representation of [scopedRoleMembership](../resources/scopedrolemembership.md) object.
v1.0 Authentication List Phonemethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/authentication-list-phonemethods.md
GET https://graph.microsoft.com/v1.0/me/authentication/phoneMethods
---- ### Response The following is an example of the response.
v1.0 Authentication List Softwareoathmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/authentication-list-softwareoathmethods.md
GET https://graph.microsoft.com/v1.0/me/authentication/softwareOathMethods
----- ### Response >**Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Authentication Post Phonemethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/authentication-post-phonemethods.md
Content-type: application/json
---- ### Response The following is an example of the response.
v1.0 Bookingbusiness Getstaffavailability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/bookingbusiness-getstaffavailability.md
POST /solutions/bookingBusinesses/{id}/getStaffAvailability
## Request body
-In the request body, pass the list of staff IDs along with two other parameters of [dateTimeTimeZone resource type](/graph/resources/datetimetimezone) called **startDateTime** and **endDateTime**. These correspond to the two timestamps between which the staff availability will be returned.
+In the request body, pass the list of staff IDs along with two other parameters of [dateTimeTimeZone resource type](/graph/api/resources/datetimetimezone) called **startDateTime** and **endDateTime**. These correspond to the two timestamps between which the staff availability will be returned.
## Response
v1.0 Calendargroup Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/calendargroup-get.md
doc_type: apiPageType
Namespace: microsoft.graph
-Retrieve the properties and relationships of a calendar group object.
+Retrieve the properties and relationships of a [calendar group](../resources/calendargroup.md) object.
## Permissions
GET /users/{id | userPrincipalName}/calendarGroups/{id}
## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and [calendarGroup](../resources/calendargroup.md) object in the response body.
+If successful, this method returns a `200 OK` response code and a [calendarGroup](../resources/calendargroup.md) object in the response body.
## Example
-##### Request
-
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/v1.0/me/calendarGroups/AAMkAGVmMDEzMTM4LTZmYWUtN
-##### Response
+### Response
+
+The following is an example of the response.
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
v1.0 Call Addlargegalleryview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/call-addlargegalleryview.md
Namespace: microsoft.graph
Add the large gallery view to a call.
-For details about how to identify a large gallery view participant in a roster so that you can retrieve the relevant data to subscribe to the video feed, see [Identify large gallery view participants in a roster](https://learn.microsoft.com/en-us/graph/cloud-communications-identifylargegalleryview).
+For details about how to identify a large gallery view participant in a roster so that you can retrieve the relevant data to subscribe to the video feed, see [Identify large gallery view participants in a roster](/graph/cloud-communications-identifylargegalleryview).
## 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).
v1.0 Call Cancelmediaprocessing https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/call-cancelmediaprocessing.md
Content-Length: 62
[!INCLUDE [sample-code](../includes/snippets/php/call-cancelmediaprocessing-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Call Updaterecordingstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/call-updaterecordingstatus.md
Content-Length: 79
-- ### Response > **Note:** The response object shown here might be shortened for readability.
v1.0 Callrecords Callrecord Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/callrecords-callrecord-get.md
Title: "Get callRecord" description: "Retrieve the properties and relationships of callrecord object." ms.localizationpriority: medium-+ ms.prod: "cloud-communications" doc_type: "apiPageType"
The following is an example of the request to get the basic details from a [call
"name": "get_callrecord" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/communications/callRecords/{id} ```
The following is an example of the request to get the full details from a [callR
"name": "get_callrecord_expanded" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/communications/callRecords/{id}?$expand=sessions($expand=segments) ```
v1.0 Channel Getallmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-getallmessages.md
Retrieve [messages](../resources/chatmessage.md) across all [channels](../resour
To learn more about how to use the Microsoft Teams export APIs to export content, see [Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content). ## Permissions
v1.0 Channel Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-post.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-private-channel-upn-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] ---- #### Response
v1.0 Chat Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-get.md
Retrieve a single [chat](../resources/chat.md) (without its messages).
This method supports federation. To access a chat, at least one chat member must belong to the tenant the request initiated from.
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
The following is an example of the request.
<!-- { "blockType": "request", "name": "get_group_chat",
- "sampleKeys": ["19:d0f51aeb0e8e43d0befb24be72b09ea7@thread.v2"]
+ "sampleKeys": ["19:b8577894a63548969c5c92bb9c80c5e1@thread.v2"]
}--> ```msgraph-interactive GET https://graph.microsoft.com/v1.0/chats/19:b8577894a63548969c5c92bb9c80c5e1@thread.v2
The following is an example of the request.
<!-- { "blockType": "request", "name": "get_chat_withmembers",
- "sampleKeys": ["19:d0f51aeb0e8e43d0befb24be72b09ea7@thread.v2"]
+ "sampleKeys": ["19:b8577894a63548969c5c92bb9c80c5e1@thread.v2"]
}--> ```msgraph-interactive GET https://graph.microsoft.com/v1.0/chats/19:b8577894a63548969c5c92bb9c80c5e1@thread.v2?$expand=members
The following is an example of the request.
<!-- { "blockType": "request", "name": "get_meeting_chat",
- "sampleKeys": ["19:meeting_ZDZlYTYxOWUtYzdlMi00ZmMxLWIxMTAtN2YzODZlZjAxYzI4@thread.v2"]
+ "sampleKeys": ["19:ebe3857aa388434bab0cad9d2e09f4de@thread.v2"]
}--> ```msgraph-interactive GET https://graph.microsoft.com/v1.0/chats/19:ebe3857aa388434bab0cad9d2e09f4de@thread.v2?$expand=lastMessagePreview
v1.0 Chat Hideforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-hideforuser.md
Content-Type: application/json
---- ### Response <!-- {
v1.0 Chat List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-list-messages.md
Retrieve the list of [messages](../resources/chatmessage.md) in a [chat](../reso
This method supports federation. To list chat messages in application context, the request must be made from the tenant that the channel owner belongs to (represented by the **tenantId** property on the channel).
-> **Note**: This API supports subscribing to changes (create, update, and delete) using [change notifications](../resources/webhooks.md). This allows callers to subscribe and get changes in real time. For details, see [Get notifications for messages](/graph/teams-changenotifications-chatmessage).
+> **Notes**:
+> - This API supports subscribing to changes (create, update, and delete) using [change notifications](../resources/webhooks.md). This allows callers to subscribe and get changes in real time. For details, see [Get notifications for messages](/graph/teams-changenotifications-chatmessage).
+> - This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
## Permissions
v1.0 Chat List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-list.md
Retrieve the list of [chats](../resources/chat.md) that the user is part of.
This method supports federation. When a user ID is provided, the calling application must belong to the same tenant that the user belongs to.
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
This method supports the following [OData query parameters](/graph/query-paramet
The other [OData query parameters](/graph/query-parameters) are not currently supported.
+> [!NOTE]
+> The `$top` query parameter might not return all chats within a single response object. If the result set for all chats spans multiple pages, the response object includes an **@odata.nextLink** property that contains a URL to the next page of results. If that property is present, continue making additional requests with the **@odata.nextLink** URL in each response, until all the results are returned.
+ ## Request headers | Header | Value |
v1.0 Chat Markchatreadforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-markchatreadforuser.md
Content-length: 106
----- ### Response <!-- {
v1.0 Chat Markchatunreadforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-markchatunreadforuser.md
Content-length: 158
----- ### Response <!-- {
v1.0 Chat Post Pinnedmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-post-pinnedmessages.md
Content-Type: application/json
"id": "1616964509832" } ```+
+## See also
+
+- [Pinned message C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-pinned-messages/csharp)
+- [Pinned message Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-pinned-messages/nodejs)
v1.0 Chat Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-sendactivitynotification.md
HTTP/1.1 204 No Content
## See also
-[Notify Feed App C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/graph-activity-feed/csharp)
+- [Activity feed notification C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/csharp)
+- [Activity feed notification Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/nodejs)
v1.0 Chat Unhideforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-unhideforuser.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/chat-unhideforuser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Chatmessage Post Replies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chatmessage-post-replies.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | ChannelMessage.Send, Group.ReadWrite.All** | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Teamwork.Migrate.All, ChannelMessage.ReadWrite.All |
+| Application | Teamwork.Migrate.All |
> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chatmessage-post.md
Content-type: application/json
} ```
+### Example 10: Send a message that contains an announcement
+
+#### Request
+
+The following is an example of the request.
+
+> **Note:** The Base64-encoded value for the **contentBytes** property is truncated for readability.
+
+<!-- {
+ "blockType": "request",
+ "name": "post_chatmessage_10",
+ "sampleKeys": ["5c884e2f-83f8-4cff-af8e-0177f260b9f8", "19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2"]
+}-->
+
+```http
+POST https://graph.microsoft.com/beta/teams/5c884e2f-83f8-4cff-af8e-0177f260b9f8/channels/19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2/messages
+Content-type: application/json
+
+{
+ "subject": "Announcement Subheading",
+ "body": {
+ "contentType": "text",
+ "content": "<attachment id=\"d7ddbf876ae340c3a03bada395ec7da7\"></attachment>Announcement text"
+ },
+ "attachments": [
+ {
+ "id": "d7ddbf876ae340c3a03bada395ec7da7",
+ "contentType": "application/vnd.microsoft.teams.messaging-announcementBanner",
+ "contentUrl": null,
+ "content": "{\"title\":\"Announcement heading\",\"cardImageType\":\"uploadedImage\",\"cardImageDetails\":{\"uploadedImageDetail\":{\"originalImage\":{\"source\":\"../hostedContents/1/$value\",\"width\":1379,\"height\":268,\"croppedWidth\":918.0,\"croppedHeight\":178.4075416968818,\"leftMargin\":0.0,\"topMargin\":90.7962291515591,\"imageContentType\":\"image/png\"},\"croppedImage\":{\"source\":\"../hostedContents/2/$value\"}}}}",
+ "name": null,
+ "thumbnailUrl": null
+ }
+ ],
+ "hostedContents": [
+ {
+ "@microsoft.graph.temporaryId": "1",
+ "contentBytes": "iVBORw0KGgoAAAANSUhEUgAABWMAAAEMCAYAAAChuaTsAAAAAXNSR0IArs4",
+ "contentType": "image/png"
+ },
+ {
+ "@microsoft.graph.temporaryId": "2",
+ "contentBytes": "iVBORw0KGgoAAAANSUhEUgAAA5YAAAB4CAYAAACJrW0RAAAAAXNSR0IArs4",
+ "contentType": "image/png"
+ }
+ ]
+}
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.chatMessage"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('5c884e2f-83f8-4cff-af8e-0177f260b9f8')/channels('19%3A81f49626414645c99469ee65a1a7e1a4%40thread.tacv2')/messages/$entity",
+ "id": "1675104302171",
+ "replyToId": null,
+ "etag": "1675104302171",
+ "messageType": "message",
+ "createdDateTime": "2023-01-30T18:45:02.171Z",
+ "lastModifiedDateTime": "2023-01-30T18:45:02.171Z",
+ "lastEditedDateTime": null,
+ "deletedDateTime": null,
+ "subject": "Announcement Subheading",
+ "summary": null,
+ "chatId": null,
+ "importance": "normal",
+ "locale": "en-us",
+ "webUrl": "https://teams.microsoft.com/l/message/19%3A81f49626414645c99469ee65a1a7e1a4%40thread.tacv2/1675104302171?groupId=5c884e2f-83f8-4cff-af8e-0177f260b9f8&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1675104302171&parentMessageId=1675104302171",
+ "onBehalfOf": null,
+ "policyViolation": null,
+ "eventDetail": null,
+ "from": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "28c10244-4bad-4fda-993c-f332faef94f0",
+ "displayName": "Test User",
+ "userIdentityType": "aadUser"
+ }
+ },
+ "body": {
+ "contentType": "text",
+ "content": "<attachment id=\"d7ddbf876ae340c3a03bada395ec7da7\"></attachment>Announcement text"
+ },
+ "channelIdentity": {
+ "teamId": "5c884e2f-83f8-4cff-af8e-0177f260b9f8",
+ "channelId": "19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2"
+ },
+ "attachments": [
+ {
+ "id": "d7ddbf876ae340c3a03bada395ec7da7",
+ "contentType": "application/vnd.microsoft.teams.messaging-announcementBanner",
+ "contentUrl": null,
+ "content": "{\"title\":\"Announcement heading\",\"cardImageType\":\"uploadedImage\",\"cardImageDetails\":{\"uploadedImageDetail\":{\"originalImage\":{\"source\":\"https://graph.microsoft.com/beta/teams/5c884e2f-83f8-4cff-af8e-0177f260b9f8/channels/19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2/messages/1675104302171/hostedContents/aWQ9LHR5cGU9MSx1cmw9aHR0cHM6Ly91cy1hcGkuYXNtLnNreXBlLmNvbS92MS9vYmplY3RzLzAtd3VzLWQyLTY3OTJlM2ExMzFmNzc4YjY5NWMwYTE5ZGRkZmIwYWNiL3ZpZXdzL2ltZ28=/$value\",\"width\":1379,\"height\":268,\"croppedWidth\":918.0,\"croppedHeight\":178.4075416968818,\"leftMargin\":0.0,\"topMargin\":90.7962291515591,\"imageContentType\":\"image/png\"},\"croppedImage\":{\"source\":\"https://graph.microsoft.com/beta/teams/5c884e2f-83f8-4cff-af8e-0177f260b9f8/channels/19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2/messages/1675104302171/hostedContents/aWQ9LHR5cGU9MSx1cmw9aHR0cHM6Ly91cy1hcGkuYXNtLnNreXBlLmNvbS92MS9vYmplY3RzLzAtd3VzLWQzLTAwYjhhNWZiZTA0MGRmY2MzMWZkNzM1ZDE4Yjk4NTM5L3ZpZXdzL2ltZ28=/$value\"}}}}",
+ "name": null,
+ "thumbnailUrl": null,
+ "teamsAppId": null
+ }
+ ],
+ "mentions": [],
+ "reactions": []
+}
+```
+ ## See also -- [Cards reference](/microsoftteams/platform/concepts/cards/cards-reference)
+* [Cards reference](/microsoftteams/platform/concepts/cards/cards-reference)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Chatmessage Softdelete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chatmessage-softdelete.md
Namespace: microsoft.graph
Delete a single [message](../resources/chatmessage.md) or a [message reply](../resources/chatmessage.md) in a [channel](../resources/channel.md) or a [chat](../resources/chat.md).
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
v1.0 Chatmessage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chatmessage-update.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | ChannelMessage.ReadWrite, Group.ReadWrite.All** | | Delegated (personal Microsoft account) | Not supported. |
-| Application | ChannelMessage.UpdatePolicyViolation.All, ChannelMessage.ReadWrite.All, Group.ReadWrite.All** |
+| Application | ChannelMessage.UpdatePolicyViolation.All, Group.ReadWrite.All** |
> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
v1.0 Chats Getallmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chats-getallmessages.md
Namespace: microsoft.graph
Get all [messages](../resources/chatmessage.md) from all [chats](../resources/chat.md) that a user is a participant in, including one-on-one chats, group chats, and meeting chats. ## Permissions
v1.0 Cloudcommunications Getpresencesbyuserid https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/cloudcommunications-getpresencesbyuserid.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/get-presence-multiple-users-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Conditionalaccesspolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/conditionalaccesspolicy-delete.md
DELETE https://graph.microsoft.com/v1.0/identity/conditionalAccess/policies/{id}
[!INCLUDE [sample-code](../includes/snippets/php/delete-conditionalaccesspolicy-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Conditionalaccesspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/conditionalaccesspolicy-get.md
GET https://graph.microsoft.com/v1.0/identity/conditionalAccess/policies/{id}
[!INCLUDE [sample-code](../includes/snippets/php/get-conditionalaccesspolicy-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Conditionalaccesspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/conditionalaccesspolicy-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-conditionalaccesspolicy-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Conditionalaccessroot List Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/conditionalaccessroot-list-policies.md
GET https://graph.microsoft.com/v1.0/identity/conditionalAccess/policies
[!INCLUDE [sample-code](../includes/snippets/php/get-policies-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Conditionalaccessroot Post Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/conditionalaccessroot-post-policies.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-conditionalaccesspolicy-from-conditionalaccessroot-1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
v1.0 Contenttype Associatewithhubsites https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/contenttype-associatewithhubsites.md
Content-Type: application/json
----- ### Response
v1.0 Crosstenantaccesspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/crosstenantaccesspolicy-get.md
If successful, this method returns a `200 OK` response code and a [crossTenantAc
### Request -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_crosstenantaccesspolicy"
If successful, this method returns a `200 OK` response code and a [crossTenantAc
GET https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PowerShell](#tab/powershell)
-
-# [PHP](#tab/php)
---- ### Response <!-- {
Content-Type: application/json
"value": { "@odata.type": "#microsoft.graph.crossTenantAccessPolicy", "displayName": "CrossTenantAccessPolicy",
- "definition": "Cross tenant access policy..."
+ "allowedCloudEndpoints": ["microsoftonline.us", "partner.microsoftonline.cn"]
} } ```
v1.0 Crosstenantaccesspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/crosstenantaccesspolicy-update.md
PATCH /policies/crossTenantAccessPolicy
|Property|Type|Description| |:|:|:| |displayName|String|The display name of the cross-tenant access policy.|
+| allowedCloudEndpoints | String collection | Used to specify which Microsoft clouds an organization would like to collaborate with. By default, this value is empty. Supported values for this field are: `microsoftonline.com`, `microsoftonline.us`, and `partner.microsoftonline.cn`. |
## Response
The [crossTenantAccessPolicy](../resources/crosstenantaccesspolicy.md) object si
### Request -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_crosstenantaccesspolicy"
PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy
Content-Type: application/json {
- "displayName": "CrossTenantAccessPolicy",
+ "allowedCloudEndpoints": ["microsoftonline.us"]
} ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PowerShell](#tab/powershell)
-
-# [PHP](#tab/php)
---- ### Response <!-- {
v1.0 Device Delete Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-delete-registeredowners.md
DELETE https://graph.microsoft.com/v1.0/devices/{id}/registeredOwners/{id}/$ref
[!INCLUDE [sample-code](../includes/snippets/php/delete-registeredowners-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Device Delete Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-delete-registeredusers.md
DELETE https://graph.microsoft.com/v1.0/devices/{id}/registeredUsers/{id}/$ref
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ##### Response
v1.0 Device Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-delete.md
Title: "Delete device" description: "Delete a registered device."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device List Memberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-list-memberof.md
Title: "List device memberships" description: "Get groups and administrative units that this device is a direct member of. This operation is not transitive."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device List Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-list-registeredowners.md
Title: "List registeredOwners" description: "Retrieve a list of users that are registered owners of the device." ms.localizationpriority: medium-+ ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device List Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-list-registeredusers.md
Title: "List registeredUsers" description: "Retrieve a list of users that are registered users of the device."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device List Transitivememberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-list-transitivememberof.md
Title: "List device transitive memberships" description: "Get groups and administrative units that the device is a member of."-+ ms.prod: "directory-management" ms.localizationpriority: medium doc_type: apiPageType
v1.0 Device Post Devices https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-post-devices.md
Title: "Create device" description: "Create and register a new device in the organization."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device Post Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-post-registeredowners.md
Title: "Create registeredOwner" description: "Add a user as a registered owner of the device."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Device Post Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-post-registeredusers.md
Title: "Create registeredUser" description: "Add a registered user for the device."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Directory Deleteditems Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/directory-deleteditems-delete.md
If successful, this method returns `204 No Content` response code. It does not r
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "delete_directory"
+ "name": "delete_directory_deleteditem"
}--> ```http DELETE https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}
v1.0 Directory Deleteditems Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/directory-deleteditems-get.md
The following is an example of a request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "get_directory"
+ "name": "get_directory_deleteditem"
}--> ```msgraph-interactive GET https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}
v1.0 Directory Deleteditems Getuserownedobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/directory-deleteditems-getuserownedobjects.md
Successful requests return `200 OK` response codes; the response object includes
## Example
-##### Request
+### Request
Here is an example of the request.
+<!-- {
+ "blockType": "request",
+ "name": "get_directory_deleteditem_getuserownedobjects"
+}-->
``` http POST https://graph.microsoft.com/v1.0/directory/deletedItems/getUserOwnedObjects Content-type: application/json
-```
-``` json
{ "userId":"55ac777c-109e-4022-b58c-470c8fcb6892", "type":"Group" } ```
-###### Response
+### Response
Here is an example of the response. Note: This response object may be truncated for brevity. All supported properties are returned from actual calls.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.directoryObject",
+ "isCollection": true
+} -->
``` http
-HTTP/1.1 200
+HTTP/1.1 200 OK
Content-type: application/json {
-"value": [
- {
- "@odata.type": "#microsoft.graph.group",
- "id": "bfa7033a-7367-4644-85f5-95aaf385cbd7",
- "deletedDateTime": 2018-04-01T12:39:16Z,
- "classification": null,
- "createdDateTime": "2017-03-22T12:39:16Z",
- "description": null,
- "displayName": "Test",
- "groupTypes": [
- "Unified"
- ],
- "mail": "Test@contoso.com",
- "mailEnabled": true,
- "mailNickname": "Test",
- "membershipRule": null,
- "membershipRuleProcessingState": null,
- "preferredDataLocation": null,
- "preferredLanguage": null,
- "proxyAddresses": [
- "SMTP:Test@contoso.com"
- ],
- "renewedDateTime": "2017-09-22T22:30:39Z",
- "securityEnabled": false,
- "theme": null,
- "visibility": "Public"
- }
- ]
- }
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.group",
+ "id": "bfa7033a-7367-4644-85f5-95aaf385cbd7",
+ "deletedDateTime": "2018-04-01T12:39:16Z",
+ "classification": null,
+ "createdDateTime": "2017-03-22T12:39:16Z",
+ "description": null,
+ "displayName": "Test",
+ "groupTypes": [
+ "Unified"
+ ],
+ "mail": "Test@contoso.com",
+ "mailEnabled": true,
+ "mailNickname": "Test",
+ "membershipRule": null,
+ "membershipRuleProcessingState": null,
+ "preferredDataLocation": null,
+ "preferredLanguage": null,
+ "proxyAddresses": [
+ "SMTP:Test@contoso.com"
+ ],
+ "renewedDateTime": "2017-09-22T22:30:39Z",
+ "securityEnabled": false,
+ "theme": null,
+ "visibility": "Public"
+ }
+ ]
+}
```
v1.0 Directory Deleteditems List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/directory-deleteditems-list.md
If successful, this method returns a `200 OK` response code and collection of [d
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "get_deleteditems"
+ "name": "list_directory_deleteditems"
}--> ```msgraph-interactive GET https://graph.microsoft.com/v1.0/directory/deletedItems/microsoft.graph.group
Content-type: application/json
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "get_deleteditems_count"
+ "name": "list_directory_deleteditems_count"
}--> ```msgraph-interactive GET https://graph.microsoft.com/v1.0/directory/deletedItems/microsoft.graph.group?$count=true&$orderBy=deletedDateTime asc&$select=id,DisplayName,deletedDateTime
v1.0 Directory Deleteditems Restore https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/directory-deleteditems-restore.md
The calling app must be assigned one of the following [Azure AD roles](/azure/ac
|Delegated (personal Microsoft account) | Not supported. | |Application | User.ReadWrite.All |
+To restore users with privileged administrator roles in delegated scenarios, the app must be assigned with *Directory.AccessAsUser.All* delegated permission, and the calling user must also be assigned a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).
+
+In app-only scenarios, the *User.ReadWrite.All* application permission isn't enough privilege to restore deleted users with privilged administrator roles. The app must be assigned a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).
+ ### For groups: |Permission type | Permissions (from least to most privileged) |
If successful, this method returns a `200 OK` response code and a [directoryObje
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "create_directoryobject_from_directory"
+ "name": "restore_directory_deleteditem"
}--> ```http POST https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}/restore
v1.0 Directory List Administrativeunits https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/directory-list-administrativeunits.md
GET https://graph.microsoft.com/v1.0/directory/administrativeUnits
[!INCLUDE [sample-code](../includes/snippets/php/get-administrativeunits-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Directory Post Administrativeunits https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/directory-post-administrativeunits.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-administrativeunit-from-administrativeunits-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- In the request body, supply a JSON representation of an [administrativeUnit](../resources/administrativeunit.md) object.
v1.0 Domain Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/domain-delete.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Domain Forcedelete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/domain-forcedelete.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Domain Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/domain-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.Read.All, Domain.ReadWrite.All, Directory.Read.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* User Administrator
+* Helpdesk Administrator
+* Service Support Administrator
+* Billing Administrator
+* Mailbox Administrator
+* Partner Tier1 Support
+* Partner Tier2 Support
+* Directory Readers
+* Directory Writers
+* AdHoc License Administrator
+* Application Administrator
+* Security Reader
+* Security Administrator
+* Privileged Role Administrator
+* Cloud Application Administrator
+* Customer LockBox Access Approver
+* Dynamics 365 Administrator
+* Power BI Administrator
+* Azure Information Protection Administrator
+* Desktop Analytics Administrator
+* License Administrator
+* Microsoft Managed Desktop Administrator
+* Authentication Administrator
+* Privileged Authentication Administrator
+* Teams Communications Administrator
+* Teams Communications Support Engineer
+* Teams Communications Support Specialist
+* Teams Administrator
+* Insights Administrator
+* Compliance Data Administrator
+* Security Operator
+* Kaizala Administrator
+* Global Reader
+* Volume Licensing Business Center User
+* Volume Licensing Service Center User
+* Modern Commerce User
+* Microsoft Store for Business User
+* Directory Reviewer
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Domain List Domainnamereferences https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/domain-list-domainnamereferences.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.Read.All, Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+* Global Reader
+ [!INCLUDE [limited-info](../../includes/limited-info.md)] ## HTTP request
v1.0 Domain List Verificationdnsrecords https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/domain-list-verificationdnsrecords.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.Read.All, Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+* Global Reader
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Domain List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/domain-list.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.Read.All, Domain.ReadWrite.All, Directory.Read.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* User Administrator
+* Helpdesk Administrator
+* Service Support Administrator
+* Billing Administrator
+* Mailbox Administrator
+* Partner Tier1 Support
+* Partner Tier2 Support
+* Directory Readers
+* Directory Writers
+* AdHoc License Administrator
+* Application Administrator
+* Security Reader
+* Security Administrator
+* Privileged Role Administrator
+* Cloud Application Administrator
+* Customer LockBox Access Approver
+* Dynamics 365 Administrator
+* Power BI Administrator
+* Azure Information Protection Administrator
+* Desktop Analytics Administrator
+* License Administrator
+* Microsoft Managed Desktop Administrator
+* Privileged Authentication Administrator
+* Teams Communications Administrator
+* Teams Communications Support Engineer
+* Authentication Administrator
+* Teams Communications Support Specialist
+* Teams Administrator
+* Insights Administrator
+* Compliance Data Administrator
+* Security Operator
+* Kaizala Administrator
+* Global Reader
+* Volume Licensing Business Center User
+* Volume Licensing Service Center User
+* Modern Commerce User
+* Microsoft Store for Business User
+* Directory Reviewer
+* Domain Name Administrator
+* Users
+* Guest User
+* Restricted Guest User
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Domain Post Domains https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/domain-post-domains.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Domain Post Federationconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/domain-post-federationconfiguration.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported| |Application|Domain.ReadWrite.All|
-The calling user must be assigned the Global Administrator [Azure AD role](/azure/active-directory/roles/permissions-reference).
+The calling user must be assigned one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+- Security Administrator
+- External Identity Provider Administrator
## HTTP request
v1.0 Domain Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/domain-update.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+* Security Administrator
+* External Identity Provider Administrator
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Domain Verify https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/domain-verify.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Driveitem Invite https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/driveitem-invite.md
In the request body, provide a JSON object with the following parameters.
| message | String | A plain text formatted message that is included in the sharing invitation. Maximum length 2000 characters. | requireSignIn | Boolean | Specifies whether the recipient of the invitation is required to sign-in to view the shared item. | sendInvitation | Boolean | If true, a [sharing link][] is sent to the recipient. Otherwise, a permission is granted directly without sending a notification.
-| roles | Collection(String) | Specify the roles that are to be granted to the recipients of the sharing invitation.
-| expirationDateTime | DateTimeOffset | Specify the DateTime after which the permission expires. Available on OneDrive for Business, SharePoint, and premium personal OneDrive accounts.
+| roles | Collection(String) | Specifies the roles that are to be granted to the recipients of the sharing invitation.
+| expirationDateTime | DateTimeOffset | Specifies the **dateTime** after which the permission expires. For OneDrive for Business and SharePoint, **xpirationDateTime** is only applicable for **sharingLink** permissions. Available on OneDrive for Business, SharePoint, and premium personal OneDrive accounts.
| password | String | The password set on the invite by the creator. Optional and OneDrive Personal only. ## Example
v1.0 Educationsubmission Reassign https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/educationsubmission-reassign.md
POST /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332
--- #### Response The following is an example of the response when `Prefer: include-unknown-enum-members` is NOT provided in the request header and the submission hasn't been returned before.
Prefer: include-unknown-enum-members
--- #### Response The following is an example of the response when `Prefer: include-unknown-enum-members` is provided in the request header and the submission hasn't been returned before.
v1.0 Educationsubmission Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/educationsubmission-setupresourcesfolder.md
Content-type: application/json
-- #### Response The following is an example of the response.
v1.0 Educationuser List Assignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/educationuser-list-assignments.md
GET https://graph.microsoft.com/v1.0/education/me/assignments
-- #### Response The following is an example of the response.
GET https://graph.microsoft.com/v1.0/education/users/f3a5344e-dbde-48b0-be24-b5b
--- #### Response If user tries to query a different user-id than his own, this method returns a `403 Forbidden` response code.
GET https://graph.microsoft.com/v1.0/education/users/80cefd93-8d88-40e2-b5d3-678
--- #### Response The following is an example of the response.
v1.0 Emailauthenticationmethod Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/emailauthenticationmethod-delete.md
DELETE https://graph.microsoft.com/v1.0/users/kim@contoso.com/authentication/ema
----- ### Response The following is an example of the response. <!-- {
v1.0 Emailauthenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/emailauthenticationmethod-get.md
GET https://graph.microsoft.com/v1.0/me/authentication/emailMethods/3ddfcfc8-938
----- ### Response The following is an example of the response.
v1.0 Emailauthenticationmethod Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/emailauthenticationmethod-update.md
Content-Type: application/json
----- ### Response The following is an example of the response.
v1.0 Event Forward https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/event-forward.md
Content-type: application/json
{ "ToRecipients":[ {
- "emailAddress": {
- "address":"danas@contoso.onmicrosoft.com",
- "name":"Dana Swope"
+ "EmailAddress": {
+ "Address":"danas@contoso.onmicrosoft.com",
+ "Name":"Dana Swope"
} } ],
v1.0 Group Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/group-post-members.md
The following table shows the least privileged permission that's required by eac
| [group](../resources/group.md) | GroupMember.ReadWrite.All and Group.ReadWrite.All | Not supported. | GroupMember.ReadWrite.All and Group.ReadWrite.All | | [orgContact](../resources/device.md) | GroupMember.ReadWrite.All and OrgContact.Read.All | Not supported. | GroupMember.ReadWrite.All and OrgContact.Read.All | | [servicePrincipal](../resources/group.md) | GroupMember.ReadWrite.All and Application.ReadWrite.All | Not supported. | GroupMember.ReadWrite.All and Application.ReadWrite.All |
-| [user](../resources/user.md) | GroupMember.ReadWrite.All and User.ReadWrite.All | Not supported. | UGroupMember.ReadWrite.All and User.ReadWrite.All |
+| [user](../resources/user.md) | GroupMember.ReadWrite.All and User.ReadWrite.All | Not supported. | GroupMember.ReadWrite.All and User.ReadWrite.All |
> [!IMPORTANT] > To add members to a role-assignable group, the calling user must also be assigned the _RoleManagement.ReadWrite.Directory_ permission.
v1.0 Internaldomainfederation Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/internaldomainfederation-delete.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported| |Application|Domain.ReadWrite.All|
-The calling user must be assigned the Global Administrator [Azure AD role](/azure/active-directory/roles/permissions-reference).
+The calling user must be assigned one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+- Security Administrator
+- External Identity Provider Administrator
## HTTP request
v1.0 Internaldomainfederation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/internaldomainfederation-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported| |Application|Domain.Read.All, Domain.ReadWrite.All|
-The calling user must be assigned the Global Administrator [Azure AD role](/azure/active-directory/roles/permissions-reference).
+The calling user must be assigned one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+- Security Administrator
+- External Identity Provider Administrator
## HTTP request
v1.0 Internaldomainfederation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/internaldomainfederation-update.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported| |Application|Domain.ReadWrite.All|
-The calling user must be assigned the Global Administrator [Azure AD role](/azure/active-directory/roles/permissions-reference).
+The calling user must be assigned one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+
+- Security Administrator
+- External Identity Provider Administrator
## HTTP request
v1.0 Offershiftrequest Approve https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/offershiftrequest-approve.md
Content-type: application/json
--- ### Response The following example shows the response.
v1.0 Offershiftrequest Decline https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/offershiftrequest-decline.md
Content-type: application/json
---- ### Response The following example shows the response.
v1.0 Offershiftrequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/offershiftrequest-get.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/offerShiftRequests/
--- ### Response The following is an example of the response.
v1.0 Offershiftrequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/offershiftrequest-list.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/offerShiftRequests
--- ### Response The following is an example of the response.
v1.0 Offershiftrequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/offershiftrequest-post.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Onpremisesdirectorysynchronization Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/onpremisesdirectorysynchronization-get.md
+
+ Title: "Get onPremisesDirectorySynchronization"
+description: "Read the properties and relationships of an onPremisesDirectorySynchronization object."
+
+ms.localizationpriority: medium
++
+# Get onPremisesDirectorySynchronization
+
+Namespace: microsoft.graph
+
+Read the properties and relationships of an [onPremisesDirectorySynchronization](../resources/onpremisesdirectorysynchronization.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+| :- | : |
+| Delegated (work or school account) | OnPremDirectorySynchronization.Read.All, OnPremDirectorySynchronization.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+For delegated scenarios, the user needs to be assigned the *Global Administrator* [role](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /directory/onPremisesSynchronization
+```
+
+## Optional query parameters
+
+This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+| Name | Description |
+| : | : |
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an [onPremisesDirectorySynchronization](../resources/onpremisesdirectorysynchronization.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_onpremisesdirectorysynchronization"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/directory/onPremisesSynchronization/{id}
+```
+
+### Response
+
+The following is an example of the response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.onPremisesDirectorySynchronization"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directory/onPremisesSynchronization/$entity",
+ "id": "12cce4b4-4ab8-40b7-be4d-f5d7742ec185",
+ "configuration": {
+ "accidentalDeletionPrevention": {
+ "synchronizationPreventionType": "enabledForCount",
+ "alertThreshold": 500
+ }
+ },
+ "features": {
+ "passwordSyncEnabled": false,
+ "passwordWritebackEnabled": false,
+ "directoryExtensionsEnabled": false,
+ "quarantineUponUpnConflictEnabled": true,
+ "quarantineUponProxyAddressesConflictEnabled": true,
+ "softMatchOnUpnEnabled": true,
+ "cloudPasswordPolicyForPasswordSyncedUsersEnabled": false,
+ "fopeConflictResolutionEnabled": false,
+ "unifiedGroupWritebackEnabled": false,
+ "userWritebackEnabled": false,
+ "deviceWritebackEnabled": false,
+ "synchronizeUpnForManagedUsersEnabled": true,
+ "userForcePasswordChangeOnLogonEnabled": false,
+ "concurrentOrgIdProvisioningEnabled": false,
+ "concurrentCredentialUpdateEnabled": false,
+ "groupWriteBackEnabled": false,
+ "blockSoftMatchEnabled": false,
+ "blockCloudObjectTakeoverThroughHardMatchEnabled": false,
+ "bypassDirSyncOverridesEnabled": false
+ }
+}
+```
v1.0 Onpremisesdirectorysynchronization Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/onpremisesdirectorysynchronization-update.md
+
+ Title: "Update onPremisesDirectorySynchronization"
+description: "Update the properties of an onPremisesDirectorySynchronization object."
+
+ms.localizationpriority: medium
++
+# Update onPremisesDirectorySynchronization
+
+Namespace: microsoft.graph
+
+Update the properties of an [onPremisesDirectorySynchronization](../resources/onpremisesdirectorysynchronization.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+| :- | :- |
+| Delegated (work or school account) | OnPremDirectorySynchronization.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+For delegated scenarios, the user needs to be assigned the *Global Administrator* [role](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /directory/onPremisesSynchronization/{id}
+```
+
+## Request headers
+
+| Name | Description |
+| : | :-- |
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
+
+## Request body
++
+| Property | Type | Description |
+| : | :-- | : |
+| configuration | [onPremisesDirectorySynchronizationConfiguration](../resources/onpremisesdirectorysynchronizationconfiguration.md) | Consists of configurations that can be fine-tuned and impact the on-premises directory synchronization process for a tenant. |
+| features | [onPremisesDirectorySynchronizationFeature](../resources/onpremisesdirectorysynchronizationfeature.md) | Consists of directory synchronization features that can be enabled or disabled. |
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_onpremisesdirectorysynchronization"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/directory/onPremisesSynchronization/{id}
+Content-Type: application/json
+Content-length: 293
+
+{
+ "configuration": {
+ "accidentalDeletionPrevention": {
+ "synchronizationPreventionType": "enabledForCount",
+ "alertThreshold": 500
+ }
+ },
+ "features": {
+ "groupWriteBackEnabled": true
+ }
+}
+```
+
+### Response
+
+The following is an example of the response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Openshift Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/openshift-delete.md
DELETE https://graph.microsoft.com/v1.0/teams/3d88b7a2-f988-4f4b-bb34-d66df66af1
--- ### Response The following is an example of the response.
v1.0 Openshift Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/openshift-get.md
GET https://graph.microsoft.com/v1.0/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/
--- ### Response The following is an example of the response.
v1.0 Openshift List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/openshift-list.md
GET https://graph.microsoft.com/v1.0/teams/{id}/schedule/openShifts
--- ### Response The following is an example of the response.
v1.0 Openshift Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/openshift-update.md
Content-type: application/json
---- ### Response The following is an example of the response.
v1.0 Participant Startholdmusic https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/participant-startholdmusic.md
Content-type: application/json
---- ### Response > **Note:** The response object shown here might be shortened for readability.
v1.0 Participant Stopholdmusic https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/participant-stopholdmusic.md
Content-type: application/json
---- ### Response > **Note:** The response object shown here might be shortened for readability.
v1.0 Phoneauthenticationmethod Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/phoneauthenticationmethod-delete.md
DELETE https://graph.microsoft.com/v1.0/me/authentication/phoneMethods/3179e48a-
---- ### Response The following is an example of the response.
v1.0 Phoneauthenticationmethod Disablesmssignin https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/phoneauthenticationmethod-disablesmssignin.md
POST https://graph.microsoft.com/v1.0/me/authentication/phoneMethods/3179e48a-75
---- ### Response The following is an example of the response.
v1.0 Phoneauthenticationmethod Enablesmssignin https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/phoneauthenticationmethod-enablesmssignin.md
POST https://graph.microsoft.com/v1.0/me/authentication/phoneMethods/3179e48a-75
----- ### Response The following is an example of the response.
v1.0 Phoneauthenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/phoneauthenticationmethod-get.md
GET https://graph.microsoft.com/v1.0/me/authentication/phoneMethods/3179e48a-750
---- ### Response The following is an example of the response.
v1.0 Phoneauthenticationmethod Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/phoneauthenticationmethod-update.md
Content-type: application/json
---- ### Response The following is an example of the response.
v1.0 Presence Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/presence-get.md
GET https://graph.microsoft.com/v1.0/me/presence
---- #### Response <!-- {
GET https://graph.microsoft.com/v1.0/users/66825e03-7ef5-42da-9069-724602c31f6b/
---- #### Response <!-- {
GET https://graph.microsoft.com/v1.0/communications/presences/dc74d9bb-6afe-433d
---- #### Response <!-- {
v1.0 Printer Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/printer-delete.md
Title: "Delete printer"
-description: "Delete (unregister) a printer".
+description: "Delete (unregister) a printer."
ms.localizationpriority: medium ms.prod: "cloud-printing"
v1.0 Range Unmerge https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/range-unmerge.md
doc_type: apiPageType
Namespace: microsoft.graph Unmerge the range cells into separate cells.+ ## 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).
POST /me/drive/items/{id}/workbook/worksheets/{id|name}/range(address='<address>
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/range(address='<address>')/unmerge POST /me/drive/items/{id}/workbook/tables/{id|name}/columns/{id|name}/range/unmerge POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/range/unmerge- ```+ ## Request headers | Name | Description| |:|:-|
POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/ra
## Response
-If successful, this method returns `200 OK` response code. It does not return anything in the response body.
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
## Example
-Here is an example of how to call this API.
-##### Request
-Here is an example of the request.
+
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
POST https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/names/{name}/
-##### Response
-Here is an example of the response.
+### Response
+The following is an example of the response.
<!-- { "blockType": "response", "truncated": true } --> ```http
-HTTP/1.1 200 OK
+HTTP/1.1 204 No Content
``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Rbacapplication List Roleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/rbacapplication-list-roleassignments.md
GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignments?$f
--- #### Response The following is an example of the response.
GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignments?$f
--- #### Response The following is an example of the response.
v1.0 Riskyserviceprincipal Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/riskyserviceprincipal-get.md
GET https://graph.microsoft.com/v1.0/identityProtection/riskyServicePrincipals/9
----- ### Response <!-- { "blockType": "response",
v1.0 Schedule Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedule-get.md
GET https://graph.microsoft.com/v1.0/teams/02bd9fd6-8f93-4758-87c3-1fb73740a315/
--- ### Response The following is an example of the response.
v1.0 Schedule List Schedulinggroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedule-list-schedulinggroups.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/schedulingGroups
---- ### Response The following is an example of the response.
v1.0 Schedule List Shifts https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedule-list-shifts.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/shifts?$filter=shar
--- ### Response The following is an example of the response.
v1.0 Schedule List Timeoffreasons https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedule-list-timeoffreasons.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timeOffReasons
--- #### Response The following is an example of the response.
v1.0 Schedule List Timesoff https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedule-list-timesoff.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timesOff?$filter=sh
--- ### Response The following is an example of the response.
v1.0 Schedule Post Schedulinggroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedule-post-schedulinggroups.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Schedule Post Shifts https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedule-post-shifts.md
Namespace: microsoft.graph
Create a new [shift](../resources/shift.md) instance in a [schedule](../resources/schedule.md).
+The duration of a shift cannot be less than 1 minute or longer than 24 hours.
+ ## 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).
Content-type: application/json
--- #### Response The following is an example of the response.
v1.0 Schedule Post Timeoffreasons https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedule-post-timeoffreasons.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Schedule Post Timesoff https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedule-post-timesoff.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/timeoff-post-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- ### Response
v1.0 Schedule Share https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedule-share.md
Content-type: application/json
---- ### Response The following is an example of the response.
v1.0 Schedulinggroup Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedulinggroup-delete.md
DELETE https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/schedulingGroups
--- ### Response The following is an example of the response.
v1.0 Schedulinggroup Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedulinggroup-get.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/schedulingGroups/{s
--- ### Response The following is an example of the response.
v1.0 Schedulinggroup Put https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/schedulinggroup-put.md
Prefer: return=representation
--- ### Response The following is an example of the response.
v1.0 Search Query https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/search-query.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | Mail.Read, Calendars.Read, Files.Read.All, Sites.Read.All, ExternalItem.Read.All, Acronym.Read.All, Bookmark.Read.All, ChannelMessage.Read.All, Chat.Read | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | Files.Read.All, Sites.Read.All |
## HTTP request
v1.0 Securescorecontrolprofile Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/securescorecontrolprofile-get.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /security/securescorecontrolprofiles/{id}
+GET /security/secureScoreControlProfiles/{id}
``` ## Request headers
v1.0 Security Ediscoveryreviewset Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/security-ediscoveryreviewset-get.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /ediscoveryExportOperation/reviewSet
+GET /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets/{reviewSetId}
``` ## Optional query parameters
v1.0 Serviceprincipal Post Serviceprincipals https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/serviceprincipal-post-serviceprincipals.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All |
-> [!IMPORTANT]
-> The following additional requirements must be met for an app to create a service principal:
-> + If the backing application is registered in the calling app's home tenant, the calling app must be the owner of the backing application.
-> + If the backing application is registered in another Azure AD tenant, the calling app must be assigned the `Cloud Application Administrator` or `Application Administrator` role.
+For multi-tenant apps, the calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):
+++ Global Administrator++ Application Administrator++ Cloud Application Administrator roles+
+For single-tenant apps where the calling user is a non-admin user but is the owner of the backing application, the user must have the *Application Developer* role.
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Shift Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/shift-delete.md
DELETE https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/shifts/{shiftId}
--- ### Response The following is an example of the response.
v1.0 Shift Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/shift-get.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/shifts/{shiftId}
-- ### Response The following is an example of the response.
v1.0 Shift Put https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/shift-put.md
Replace an existing [shift](../resources/shift.md).
If the specified [shift](../resources/shift.md) doesn't exist, this method returns `404 Not found`.
+The duration of a shift cannot be less than 1 minute or longer than 24 hours.
+ ## 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).
Prefer: return=representation
--- #### Response The following is an example of the response.
v1.0 Shiftpreferences Put https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/shiftpreferences-put.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Softwareoathauthenticationmethod Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/softwareoathauthenticationmethod-delete.md
DELETE https://graph.microsoft.com/v1.0/users/kim@contoso.com/authentication/sof
----- ### Response <!-- { "blockType": "response",
v1.0 Softwareoathauthenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/softwareoathauthenticationmethod-get.md
GET https://graph.microsoft.com/v1.0/me/authentication/softwareOathMethods/b1728
----- ### Response >**Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Swapshiftschangerequest Approve https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/swapshiftschangerequest-approve.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Swapshiftschangerequest Decline https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/swapshiftschangerequest-decline.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Swapshiftschangerequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/swapshiftschangerequest-get.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/swapShiftsChangeReq
--- ### Response The following is an example of the response.
v1.0 Swapshiftschangerequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/swapshiftschangerequest-list.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/swapShiftsChangeReq
--- ### Response The following is an example of the response.
v1.0 Team Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/team-post.md
Content-Type: application/json
----- #### Response <!-- { "blockType": "response",
Content-Type: application/json
----- #### Response <!-- { "blockType": "response",
Content-Type: application/json
---- #### Response <!-- { "blockType": "response",
Content-Type: application/json
----- #### Response <!-- { "blockType": "response",
Content-Type: application/json
------ #### Response <!-- { "blockType": "response",
Content-Type: application/json
----- #### Response <!-- { "blockType": "response",
v1.0 Team Put Schedule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/team-put-schedule.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Team Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/team-sendactivitynotification.md
Content-Type: application/json
----- #### Response <!-- { "blockType": "response",
Content-Type: application/json
- #### Response The following example shows the response.
The following example shows the response.
``` http HTTP/1.1 204 No Content ```+
+## See also
+
+- [Activity feed notification C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/csharp)
+- [Activity feed notification Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/nodejs)
v1.0 Teamsapp Publish https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/teamsapp-publish.md
Content-type: application/zip
-- For information about how to create a Microsoft Teams application zip file, see [Create an app package](/microsoftteams/platform/concepts/apps/apps-package). #### Response
Content-type: application/zip
[!INCLUDE [sample-code](../includes/snippets/php/create-teamsapp-2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- #### Response
v1.0 Timeoff Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/timeoff-delete.md
DELETE https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timesOff/{timeOf
---- #### Response The following is an example of the response.
v1.0 Timeoff Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/timeoff-get.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timesOff/{timeOffId
--- #### Response The following is an example of the response.
v1.0 Timeoff Put https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/timeoff-put.md
Prefer: return=representation
--- #### Response The following is an example of the response.
v1.0 Timeoffreason Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/timeoffreason-delete.md
DELETE https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timeOffReasons/{
--- ### Response The following is an example of the response.
v1.0 Timeoffreason Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/timeoffreason-get.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timeOffReasons/{tim
--- #### Response The following is an example of the response.
v1.0 Timeoffreason Put https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/timeoffreason-put.md
Prefer: return=representation
--- ### Response The following is an example of the response.
v1.0 Timeoffrequest Approve https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/timeoffrequest-approve.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Timeoffrequest Decline https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/timeoffrequest-decline.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Timeoffrequest Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/timeoffrequest-delete.md
DELETE https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timeOffRequests/
--- ### Response The following is an example of the response.
v1.0 Timeoffrequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/timeoffrequest-get.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timeOffRequests/{ti
--- ### Response The following is an example of the response.
v1.0 Timeoffrequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/timeoffrequest-list.md
GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timeOffRequests
-- ### Response The following is an example of the response.
v1.0 User Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-delete.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | User.ReadWrite.All |
-The calling user must be assigned one of the following Azure AD roles:
-+ [User Administrator](/azure/active-directory/roles/permissions-reference#user-administrator)
-+ [Privileged Authentication Administrator](/azure/active-directory/roles/permissions-reference#privileged-authentication-administrator)
-+ [Global Administrator](/azure/active-directory/roles/permissions-reference#global-administrator)
+The calling user must be assigned one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference?toc=%2Fgraph%2Ftoc.json):
-To delete users with more privileged administrator roles, applications need to be assigned the *Directory.AccessAsUser.All* delegated permission and either the Global Admin role or the Privileged Auth Admin role.
+- User Administrator
+- Privileged Authentication Administrator
+- Global Administrator
-For more details, see [Azure AD built-in roles](/azure/active-directory/roles/permissions-reference).
+To delete users with privileged administrator roles in delegated scenarios, the app must be assigned the *Directory.AccessAsUser.All* delegated permission, and the calling user must have a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).
+
+In app-only scenarios, the *User.ReadWrite.All* application permission isn't enough privilege to delete users with privileged administrative roles. The app must be assigned a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).
## HTTP request
v1.0 User List Manager https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-list-manager.md
Returns the user or organizational contact assigned as the user's manager. Optio
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
+| Permission type | Permissions (from least to most privileged) |
+| :- | :-- |
+| Delegated (work or school account) | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
[!INCLUDE [limited-info](../../includes/limited-info.md)]
Get the
GET /me/manager GET /users/{id | userPrincipalName}/manager ```+ Get the management chain: <!-- { "blockType": "ignored" } --> ```http
GET /users/{id | userPrincipalName}/?$expand=manager($levels=n)
This method supports the `$select` and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response.
->**Note:**
-> + The `n` value of `$levels` can be `max` (to return all managers) or a number between 1 and 1000.
-> + When the `$levels` parameter is not specified, only the immediate manager is returned.
-> + You can specify `$select` inside `$expand` to select the individual manager's properties. The `$levels` parameter is required: `$expand=manager($levels=max;$select=id,displayName)`.
+>**Note:**
+>
+> + The `n` value of `$levels` can be `max` (to return all managers) or a number between 1 and 1000.
+> + When the `$levels` parameter is not specified, only the immediate manager is returned.
+> + You can specify `$select` inside `$expand` to select the individual manager's properties: `$expand=manager($levels=max;$select=id,displayName)`.
> + `$levels` parameter is only supported on a single user (`/users/{id}` or `me` endpoints) and not on the entire list of users.
-> + `$levels` requires the **ConsistencyLevel** header set to `eventual` and `$count=true` in query string. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+> + `$levels` requires the **ConsistencyLevel** header set to `eventual`. For more information about the use of **ConsistencyLevel**, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers
-| Header | Value|
-|:--|:|
-| Authorization | Bearer {token}. Required. |
-| ConsistencyLevel | eventual. Required when the request includes the `$count=true` query string. |
+| Header | Value |
+| : | : |
+| Authorization | Bearer {token}. Required. |
+| ConsistencyLevel | eventual. Required when the request includes the `$levels=n` in the `$expand` query parameter. |
## Request body
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a [directoryObject](../resources/directoryobject.md) object in the response body.
+If successful, this method returns a `200 OK` response code and a [user](../resources/user.md) object in the response body.
## Examples
GET https://graph.microsoft.com/v1.0/users/{id|userPrincipalName}/manager
``` # [C#](#tab/csharp)+ [!INCLUDE [sample-code](../includes/snippets/csharp/get-manager-2-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript)+ [!INCLUDE [sample-code](../includes/snippets/javascript/get-manager-2-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java)+ [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go)+ [!INCLUDE [sample-code](../includes/snippets/go/get-manager-2-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)+ [!INCLUDE [sample-code](../includes/snippets/powershell/get-manager-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php)+ [!INCLUDE [sample-code](../includes/snippets/php/get-manager-2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
The following example shows a request to get the manager chain up to the root le
"name": "get_transitive_managers" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/me?$expand=manager($levels=max;$select=id,displayName)&$select=id,displayName&$count=true
+GET https://graph.microsoft.com/v1.0/me?$expand=manager($levels=max;$select=id,displayName)&$select=id,displayName
ConsistencyLevel: eventual ``` # [C#](#tab/csharp)+ [!INCLUDE [sample-code](../includes/snippets/csharp/get-transitive-managers-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript)+ [!INCLUDE [sample-code](../includes/snippets/javascript/get-transitive-managers-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java)+ [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go)+ [!INCLUDE [sample-code](../includes/snippets/go/get-transitive-managers-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)+ [!INCLUDE [sample-code](../includes/snippets/powershell/get-transitive-managers-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php)+ [!INCLUDE [sample-code](../includes/snippets/php/get-transitive-managers-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -- #### Response The following is an example of the response. Transitive managers are displayed hierarchically.
v1.0 User Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-update.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | User.ReadWrite, User.ReadWrite.All, User.ManageIdentities.All, Directory.ReadWrite.All |
+|Delegated (work or school account) | User.ReadWrite, User.ManageIdentities.All, User.EnableDisableAccount.All, User.ReadWrite.All, Directory.ReadWrite.All |
|Delegated (personal Microsoft account) | User.ReadWrite |
-|Application | User.ReadWrite.All, User.ManageIdentities.All, Directory.ReadWrite.All |
+|Application | User.ManageIdentities.All, User.EnableDisableAccount.All, User.ReadWrite.All, Directory.ReadWrite.All |
>[!NOTE]
-> - To update user properties, such as **businessPhones**, **mobilePhone** and **otherMails** for users with more privileged administrator roles, applications need to be assigned the *Directory.AccessAsUser.All* delegated permission and either the Global Admin role or the Privileged Auth Admin role. For more information about who can update sensitive properties or reset passwords, see [Authorization and privileges](/graph/api/resources/users#authorization-and-privileges).
+> - To update sensitive user properties, such as **accountEnabled**, **mobilePhone**, and **otherMails** for users with privilged administrator roles, the app must be assigned the *Directory.AccessAsUser.All* delegated permission, and the calling user must have a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).
> - Your personal Microsoft account must be tied to an Azure AD tenant to update your profile with the *User.ReadWrite* delegated permission on a personal Microsoft account. > - Updating the **identities** property requires the *User.ManageIdentities.All* permission. Also, adding a [B2C local account](../resources/objectidentity.md) to an existing **user** object is not allowed, unless the **user** object already contains a local account identity.
v1.0 Userteamwork Delete Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/userteamwork-delete-installedapps.md
Namespace: microsoft.graph
Uninstall an [app](../resources/teamsappinstallation.md) from the personal scope of the specified [user](../resources/user.md).
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
v1.0 Userteamwork Get Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/userteamwork-get-installedapps.md
Namespace: microsoft.graph
Retrieve the [app](../resources/teamsappinstallation.md) installed in the personal scope of the specified [user](../resources/user.md).
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
v1.0 Userteamwork List Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/userteamwork-list-installedapps.md
Namespace: microsoft.graph
Retrieve the list of [apps](../resources/teamsappinstallation.md) installed in the personal scope of the specified [user](../resources/user.md). > [!NOTE]
-> The `id` of a **teamsAppInstallation** resource is not the same value as the `id` of the associated **teamsApp** resource.
+> - The `id` of a **teamsAppInstallation** resource is not the same value as the `id` of the associated **teamsApp** resource.
+> - This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
## Permissions
v1.0 Userteamwork Post Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/userteamwork-post-installedapps.md
Namespace: microsoft.graph
Install an [app](../resources/teamsapp.md) in the personal scope of the specified [user](../resources/user.md).
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
v1.0 Userteamwork Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/userteamwork-sendactivitynotification.md
Content-Type: application/json
-- #### Response+ <!-- { "blockType": "response", "truncated": false
Content-Type: application/json
``` http HTTP/1.1 204 No Content ```+
+## See also
+
+- [Activity feed notification C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/csharp)
+- [Activity feed notification Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/nodejs)
v1.0 Userteamwork Teamsappinstallation Upgrade https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/userteamwork-teamsappinstallation-upgrade.md
Namespace: microsoft.graph
Upgrade an [app installation](../resources/teamsappinstallation.md) in the personal scope of the specified [user](../resources/user.md) to the latest version of the app.
+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## 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).
v1.0 Workbookrange Resizedrange https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/workbookrange-resizedrange.md
Title: "workbookRange: resizedRange"
-description: "Gets a range object similar to the current range object, but with its bottom-right corner expanded (or contracted) by some number of rows and columns."
+description: "Get a range object similar to the current range object, but with its bottom-right corner expanded (or contracted) by some number of rows and columns."
ms.localizationpriority: medium ms.prod: "excel"
doc_type: apiPageType
# workbookRange: resizedRange Namespace: microsoft.graph
-Gets a range object similar to the current range object, but with its bottom-right corner expanded (or contracted) by some number of rows and columns.
+
+Get a range object similar to the current range object, but with its bottom-right corner expanded (or contracted) by some number of rows and columns.
## 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).
One of the following permissions is required to call this API. To learn more, in
```http POST /me/drive/items/{id}/workbook/worksheets/{id}/range/resizedRange(deltaRows={n}, deltaColumns={n}) POST /me/drive/root:/{item-path}:/workbook/worksheets/{id}/range/resizedRange(deltaRows={n}, deltaColumns={n})- ``` ## Function parameters
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id}/range/resizedRange(de
| Name | Description| |:|:-| | Authorization | Bearer {token}. Required. |
-| Workbook-Session-Id | Workbook session Id that determines if changes are persisted or not. Optional.|
+| Workbook-Session-Id | Workbook session ID that determines if changes are persisted or not. Optional.|
## Request body Do not supply a request body for this method. ### Response
-If successful, this method returns `200 OK` response code and [workbookRange](../resources/range.md) object in the response body.
+If successful, this method returns a `200 OK` response code and a [workbookRange](../resources/range.md) object in the response body.
## Example
-Here is an example of how to call this API.
-##### Request
-Here is an example of the request.
+
+### Request
+The following is an example of the request.
<!--{ "blockType": "request", "isComposable": true,
Here is an example of the request.
POST https://graph.microsoft.com/v1.0/me/drive/root/workbook/worksheets/{id}/range/resizedRange(deltaRows={n}, deltaColumns={n}) ```
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Workforceintegration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/workforceintegration-delete.md
DELETE https://graph.microsoft.com/v1.0/teamwork/workforceIntegrations/{workforc
---- ### Response The following is an example of the response.
v1.0 Workforceintegration List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/workforceintegration-list.md
GET https://graph.microsoft.com/v1.0/teamwork/workforceIntegrations
---- ### Response The following is an example of the response.
v1.0 Workforceintegration Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/workforceintegration-post.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Workforceintegration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/workforceintegration-update.md
Content-type: application/json
--- ### Response The following is an example of the response.
v1.0 Alternativesecurityid https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/alternativeSecurityId.md
Title: "alternativeSecurityId resource type" description: "For internal use only." ms.localizationpriority: medium-+ ms.prod: "directory-management" doc_type: resourcePageType
v1.0 Anonymousguestconversationmember https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/anonymousguestconversationmember.md
+
+ Title: "anonymousGuestConversationMember resource type"
+description: "Represents an anonymous guest in a chat."
+
+ms.localizationpriority: medium
++
+# anonymousGuestConversationMember resource type
+
+Namespace: microsoft.graph
+
+Represents an anonymous guest in a chat.
+
+Anonymous users do not have a Microsoft Teams identity and can join meetings using meeting join links. For more details, see [Anonymous users](/microsoftteams/non-standard-users#anonymous-users).
++
+Inherits from [conversationMember](../resources/conversationmember.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|anonymousGuestId|String|Unique ID that represents the user. **Note:** This ID can change if the user leaves and rejoins the meeting, or joins from a different device.|
+|displayName|String|Name provided by the user when joining the meeting. Inherited from [conversationMember](../resources/conversationmember.md).|
+|id|String|Membership ID that represents this resource. Inherited from [entity](../resources/entity.md).|
+|roles|String collection|Special roles for this user. Inherited from [conversationMember](../resources/conversationmember.md).|
+|visibleHistoryStartDateTime|DateTimeOffset|The timestamp denoting how far back a conversation's history is shared with the conversation member. Inherited from [conversationMember](../resources/conversationmember.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.anonymousGuestConversationMember",
+ "baseType": "microsoft.graph.conversationMember",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.anonymousGuestConversationMember",
+ "id": "String (identifier)",
+ "roles": [
+ "String"
+ ],
+ "displayName": "String",
+ "visibleHistoryStartDateTime": "String (timestamp)",
+ "anonymousGuestId": "String"
+}
+```
+
v1.0 Authenticationmethods Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/authenticationmethods-overview.md
The authentication method APIs are used to manage a user's authentication method
|[microsoftAuthenticatorAuthenticationMethod](microsoftauthenticatorauthenticationmethod.md)|Microsoft Authenticator can be used by a user to sign-in or perform multi-factor authentication to Azure AD|Delete a Microsoft Authenticator authentication method.| |[passwordAuthenticationMethod](passwordauthenticationmethod.md)| A password is currently the default primary authentication method in Azure AD.|Reset a user's password| |[phoneAuthenticationMethod](phoneauthenticationmethod.md)|A phone can be used by a user to authenticate using [SMS or voice calls](/azure/active-directory/authentication/concept-authentication-methods#phone-options) as allowed by policy.|See a user's authentication phone numbers. Add, update, or remove a phone number for a user. Enable or disable a primary mobile phone for SMS sign-in.|
-|[softwareOathAuthenticationMethod](softwareoathauthenticationmethod.md)| Allow users to perform multifactor authentication using an application that supporters the OATH TOTP specification and provides a one-time code.|Get and delete a software OATH token assigned to a user.|
+|[softwareOathAuthenticationMethod](softwareoathauthenticationmethod.md)| Allow users to perform multifactor authentication using an application that supports the OATH TOTP specification and provides a one-time code.|Get and delete a software OATH token assigned to a user.|
|[temporaryAccessPassAuthenticationMethod](temporaryaccesspassauthenticationmethod.md)|A time-limited passcode that serves as a strong credential and allows onboarding of passwordless credentials.| Create and manage a customized time-limted passcode for a given user to use for strong authentication or recovery. |[windowsHelloForBusinessAuthenticationMethod](windowsHelloForBusinessAuthenticationMethod.md)|Windows Hello for Business is a passwordless sign-in method on Windows devices.|See devices where a user has enabled Windows Hello for Business sign-in. Delete a Windows Hello for Business credential.|
v1.0 Azurecommunicationservicesuserconversationmember https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/azurecommunicationservicesuserconversationmember.md
+
+ Title: "azureCommunicationServicesUserConversationMember resource type"
+description: "Represents an Azure Communication Services user in a chat."
+
+ms.localizationpriority: medium
++
+# azureCommunicationServicesUserConversationMember resource type
+
+Namespace: microsoft.graph
+
+Represents an Azure Communication Services user in a chat.
+
+Azure Communication Services users can join Teams meetings and Teams chats as an external user.
+
+Inherits from [conversationMember](../resources/conversationmember.md).
+
+## Methods
+None.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|azureCommunicationServicesId|String|Azure Communication Services ID of the user.|
+|displayName|String|Display name of the user. Inherited from [conversationMember](../resources/conversationmember.md).|
+|id|String|Membership ID that represents this resource. Inherited from [entity](../resources/entity.md).|
+|roles|String collection|Special roles for this user. Inherited from [conversationMember](../resources/conversationmember.md).|
+|visibleHistoryStartDateTime|DateTimeOffset|The timestamp denoting how far back a conversation's history is shared with the conversation member. Inherited from [conversationMember](../resources/conversationmember.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.azureCommunicationServicesUserConversationMember",
+ "baseType": "microsoft.graph.conversationMember",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.azureCommunicationServicesUserConversationMember",
+ "id": "String (identifier)",
+ "roles": [
+ "String"
+ ],
+ "displayName": "String",
+ "visibleHistoryStartDateTime": "String (timestamp)",
+ "azureCommunicationServicesId": "String"
+}
+```
v1.0 Callrecords Pstncalllogrow https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/callrecords-pstncalllogrow.md
Title: "pstnCallLogRow resource type"
-description: "Represents a row of data in the Public Switch Telephone Network (PSTN) call log."
+description: "Represents a row of data in the public switched telephone network (PSTN) call log."
ms.localizationpriority: medium ms.prod: "cloud-communications"
doc_type: "resourcePageType"
Namespace: microsoft.graph.callRecords
-Represents a row of data in the Public Switch Telephone Network (PSTN) call log. Each row maps to one call.
+Represents a row of data in the public switched telephone network (PSTN) call log. Each row maps to one call.
## Methods
Represents a row of data in the Public Switch Telephone Network (PSTN) call log.
|charge|Double|Amount of money or cost of the call that is charged to your account.| |conferenceId|String|ID of the audio conference.| |connectionCharge|Double|Connection fee price.|
-|currency|String|Type of currency used to calculate the cost of the call ([ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)).|
+|currency|String|Type of currency used to calculate the cost of the call. For details, see ([ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).|
|destinationContext|String|Whether the call was domestic (within a country or region) or international (outside a country or region) based on the user's location.| |destinationName|String|Country or region dialed.| |duration|Int32|How long the call was connected, in seconds.|
Represents a row of data in the Public Switch Telephone Network (PSTN) call log.
|licenseCapability|String|The license used for the call.| |operator|String|The telecommunications operator which provided PSTN services for this call. This may be Microsoft, or it may be a third-party operator via the [Operator Connect Program](https://techcommunity.microsoft.com/t5/microsoft-teams-blog/introducing-operator-connect-and-more-teams-calling-updates/ba-p/2176398).| |startDateTime|DateTimeOffset|Call start time.|
-|tenantCountryCode|String|Country code of the tenant, [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
-|usageCountryCode|String|Country code of the user, [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
+|tenantCountryCode|String|Country code of the tenant. For details, see [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
+|usageCountryCode|String|Country code of the user. For details, see [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
|userDisplayName|String|Display name of the user.| |userId|String|Calling user's ID in Graph. GUID. This and other user info will be null/empty for bot call types (ucap_in, ucap_out).|
-|userPrincipalName|String|UserPrincipalName (sign-in name) in Azure Active Directory. This is usually the same as user's SIP Address, and can be same as user's e-mail address.|
+|userPrincipalName|String|The user principal name (sign-in name) in Azure Active Directory. This is usually the same as the user's SIP address, and can be same as the user's e-mail address.|
## Relationships
v1.0 Changenotificationcollection https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/changenotificationcollection.md
None.
| Property | Type | Description | |:|:--|:|
-| validationTokens | collection(string) | Contains an array of JWT tokens generated by Microsoft Graph for the application to validate the origin of the notifications. Microsoft Graph generates a single token for each distinct app and tenant pair for an item if it exists in the value array. Keep in mind that notifications can contain a mix of items for various apps and tenants that subscribed using the same notification URL. Only provided for [change notifications with resource data](/graph/webhooks-with-resource-data). Optional. |
-| value | collection([changeNotification](changenotification.md)) | The set of notifications being sent to the notification URL. Required. |
+| validationTokens | String collection | Contains an array of JWT tokens generated by Microsoft Graph for the application to validate the origin of the notifications. Microsoft Graph generates a single token for each distinct app and tenant pair for an item if it exists in the value array. Keep in mind that notifications can contain a mix of items for various apps and tenants that subscribed using the same notification URL. Only provided for [change notifications with resource data](/graph/webhooks-with-resource-data). Optional. |
+| value | [changeNotification](changenotification.md) collection | The set of notifications being sent to the notification URL. Required. |
## Relationships
v1.0 Channel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/channel.md
The following is a JSON representation of the resource.
"suppressions": [] } -->+
+## See also
+
+- [Channel lifecycle C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-channel-lifecycle/csharp)
+- [Channel lifecycle Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-channel-lifecycle/nodejs)
v1.0 Chat https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/chat.md
The following is a JSON representation of the resource.
- [channel](channel.md) - [chatMessage](chatmessage.md)
+- [Chat lifecycle C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-chat-lifecycle/csharp)
+- [Chat lifecycle Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-chat-lifecycle/nodejs)
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Conversationmember https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/conversationmember.md
doc_type: resourcePageType
Namespace: microsoft.graph Represents a user in a [team](team.md), a [channel](channel.md), or a [chat](chat.md).
-See also [aadUserConversationMember](aaduserconversationmember.md).
## Methods
The following is a JSON representation of the resource.
} ```
+## See also
+- [aadUserConversationMember](aaduserconversationmember.md)
+- [skypeForBusinessUserConversationMember](skypeForBusinessUserConversationMember.md)
+- [anonymousGuestConversationMember](anonymousGuestConversationMember.md)
+- [skypeUserConversationMember](skypeUserConversationMember.md)
+- [microsoftAccountUserConversationMember](microsoftAccountUserConversationMember.md)
+- [azureCommunicationServicesUserConversationMember](azureCommunicationServicesUserConversationMember.md)
+ <!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 2019-02-04 14:57:30 UTC --> <!-- {
v1.0 Crosstenantaccesspolicy Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/crosstenantaccesspolicy-overview.md
For example, when you configure your trust settings to trust MFA, your MFA polic
Inbound trust settings also enable you to trust devices that are compliant, or hybrid Azure AD joined in their home directories. With inbound trust settings in cross-tenant access settings, you can now protect access to your apps and resources by requiring that external users use compliant, or hybrid Azure AD joined devices.
+## Collaborate with organizations using Azure Active Directory in different Microsoft clouds
+
+Cross-tenant access settings is used to enable collaboration with Azure AD organizations in separate Microsoft clouds. The `allowedCloudEndpoints` property enables you to specify which Microsoft clouds you'd like to extend your collaboration to. B2B collaboration is supported between the following Microsoft clouds:
+++ Microsoft Azure commercial and Microsoft Azure Government++ Microsoft Azure commercial and Microsoft Azure China+
+Learn more about [collaborating with organizations from a different Microsoft cloud](/azure/active-directory/external-identities/cross-cloud-settings).
+ ## 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.
v1.0 Crosstenantaccesspolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/crosstenantaccesspolicy.md
Represents the base policy in the directory for cross-tenant access settings.
|Property|Type|Description| |:|:|:| | displayName | String | The display name of the cross-tenant access policy. Inherited from [policyBase](../resources/policybase.md).|
+| allowedCloudEndpoints | String collection | Used to specify which Microsoft clouds an organization would like to collaborate with. By default, this value is empty. Supported values for this field are: `microsoftonline.com`, `microsoftonline.us`, and `partner.microsoftonline.cn`. |
## Relationships
The following is a JSON representation of the resource.
``` json { "@odata.type": "#microsoft.graph.crossTenantAccessPolicy",
- "displayName": "String"
+ "displayName": "String",
+ "allowedCloudEndpoints": ["String"]
} ```
v1.0 Directory https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/directory.md
Inherits from [entity](entity.md).
|administrativeUnits|[administrativeUnit](administrativeunit.md) collection| Conceptual container for user and group directory objects.| |deletedItems|[directoryObject](directoryobject.md) collection| Recently deleted items. Read-only. Nullable.| |federationConfigurations|[identityProviderBase](../resources/identityproviderbase.md) collection|Configure domain federation with organizations whose identity provider (IdP) supports either the SAML or WS-Fed protocol.|
+| onPremisesSynchronization | [onPremisesDirectorySynchronization](../resources/onpremisesdirectorysynchronization.md) | A container for on-premises directory synchronization functionalities that are available for the organization. |
## JSON representation
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/enums.md
Possible values for user account types (group membership), per Windows definitio
|terminated| |terminating| |terminationRequested|
-|unknownFutureValue|
+|unknownFutureValue|
+
+### onPremisesDirectorySynchronizationDeletionPreventionType values
+
+|Member|
+|:--|
+|disabled|
+|enabledForCount|
+|enabledForPercentage|
+
+### searchContent values
+
+|Member|
+|:|
+|sharedContent|
+|privateContent|
+|unknownFutureValue|
v1.0 Event https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/event.md
Here is a JSON representation of the resource
- [Add custom data to resources using extensions](/graph/extensibility-overview) - [Add custom data to users using open extensions](/graph/extensibility-open-users) - [Add custom data to groups using schema extensions](/graph/extensibility-schema-groups)
+- [Bulk meetings C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-bulk-meetings/csharp)
+- [Bulk meetings Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-bulk-meetings/nodejs)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/group.md
This resource supports:
| assignedLicenses | [assignedLicense](assignedlicense.md) collection | The licenses that are assigned to the group. <br><br>Returned only on `$select`. Supports `$filter` (`eq`).Read-only. | | autoSubscribeNewMembers | Boolean | Indicates if new members added to the group will be auto-subscribed to receive email notifications. You can set this property in a PATCH request for the group; do not set it in the initial POST request that creates the group. Default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`). | | classification | String | Describes a classification for the group (such as low, medium or high business impact). Valid values for this property are defined by creating a ClassificationList [setting](groupsetting.md) value, based on the [template definition](groupsettingtemplate.md).<br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `startsWith`). |
-| createdDateTime | DateTimeOffset | Timestamp of when the group was created. The value cannot be modified and is automatically populated when the group is created. 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 is `2014-01-01T00:00:00Z`. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`). Read-only. |
+| createdDateTime | DateTimeOffset | Timestamp of when the group was created. The value cannot be modified and is automatically populated when the group is created. 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 is `2014-01-01T00:00:00Z`. <br><br>Returned by default. Read-only. |
| deletedDateTime | DateTimeOffset | For some Azure Active Directory objects (user, group, application), if the object is deleted, it is first logically deleted, and this property is updated with the date and time when the object was deleted. Otherwise this property is `null`. If the object is restored, this property is updated to `null`. | | description | String | An optional description for the group. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `startsWith`) and `$search`. | | displayName | String | The display name for the group. This property is required when a group is created and cannot be cleared during updates. Maximum length is 256 characters. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values), `$search`, and `$orderBy`. |
v1.0 Intune Graph Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/intune-graph-overview.md
The following example shows how you can determine whether an application is inst
1. Get from Azure Active Directory a list of devices registered to a user: 
- https://graph.microsoft.com/users/{user}/ownedDevices 
+ `https://graph.microsoft.com/users/{user}/ownedDevices`
2. Then view the list of applications for your tenant: 
- https://graph.microsoft.com/deviceAppManagement/mobileApps  
+ `https://graph.microsoft.com/deviceAppManagement/mobileApps`
3. Take the ID from the application and determine the installation state for the application (and therefore user):
- https://graph.microsoft.com/deviceAppManagement/mobileApps/{id}/deviceStatuses/
+ `https://graph.microsoft.com/deviceAppManagement/mobileApps/{id}/deviceStatuses/`
## Accessing the Microsoft Graph API for Intune
v1.0 Mailfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/mailfolder.md
The `TotalItemCount` and `UnreadItemCount` properties of a folder allow you to c
They let you avoid queries like the following that can incur significant latency: ```http
-https://outlook.office.com/api/v1.0/me/folders/inbox/messages?$count=true&$filter=isread%20eq%20false
+https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messages?$count=true&$filter=isread%20eq%20false
``` Mail folders in Outlook can contain more than one type of items, for example, the Inbox can contain meeting request items which are distinct from mail items. `TotalItemCount` and `UnreadItemCount` include items in a mail folder irrespective of their item types.
v1.0 Microsoftaccountuserconversationmember https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/microsoftaccountuserconversationmember.md
+
+ Title: "microsoftAccountUserConversationMember resource type"
+description: "Represents a personal Microsoft account user in a chat."
+
+ms.localizationpriority: medium
++
+# microsoftAccountUserConversationMember resource type
+
+Namespace: microsoft.graph
+
+Represents a personal Microsoft account user in a chat.
++
+Inherits from [conversationMember](../resources/conversationmember.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Display name of the user. Inherited from [conversationMember](../resources/conversationmember.md).|
+|id|String|Membership ID that represents this resource. Inherited from [entity](../resources/entity.md).|
+|roles|String collection|Special roles for this user. Inherited from [conversationMember](../resources/conversationmember.md).|
+|userId|String|Microsoft Account ID of the user.|
+|visibleHistoryStartDateTime|DateTimeOffset|The timestamp denoting how far back a conversation's history is shared with the conversation member. Inherited from [conversationMember](../resources/conversationmember.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.microsoftAccountUserConversationMember",
+ "baseType": "microsoft.graph.conversationMember",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.microsoftAccountUserConversationMember",
+ "id": "String (identifier)",
+ "roles": [
+ "String"
+ ],
+ "displayName": "String",
+ "visibleHistoryStartDateTime": "String (timestamp)",
+ "userId": "String"
+}
+```
+
v1.0 Onpremisesaccidentaldeletionprevention https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/onpremisesaccidentaldeletionprevention.md
+
+ Title: "onPremisesAccidentalDeletionPrevention resource type"
+description: "Contains the accidental deletion prevention configuration for a tenant."
+
+ms.localizationpriority: medium
++
+# onPremisesAccidentalDeletionPrevention resource type
+
+Namespace: microsoft.graph
+
+Contains the accidental deletion prevention configuration for a tenant. This configuration is geared at administrators who accidentally make an on-premises Active Directory change which results in deleting a large number of objects on Azure Active Directory.
+
+## Properties
+
+| Property | Type | Description |
+| :- | :- | : |
+| alertThreshold | Int32 | Threshold value which triggers accidental deletion prevention. The threshold is either an absolute number of objects or a percentage number of objects. |
+| synchronizationPreventionType | onPremisesDirectorySynchronizationDeletionPreventionType | The status of the accidental deletion prevention feature. The possible values are: `disabled`, `enabledForCount`, `enabledForPercentage`, `unknownFutureValue`. |
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.onPremisesAccidentalDeletionPrevention"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.onPremisesAccidentalDeletionPrevention",
+ "synchronizationPreventionType": "String",
+ "alertThreshold": "Integer"
+}
+```
v1.0 Onpremisesdirectorysynchronization https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/onpremisesdirectorysynchronization.md
+
+ Title: "onPremisesDirectorySynchronization resource type"
+description: "A container for on-premises directory synchronization functionalities that are available for the organization."
+
+ms.localizationpriority: medium
++
+# onPremisesDirectorySynchronization resource type
+
+Namespace: microsoft.graph
+
+A container for on-premises directory synchronization functionalities that are available for the organization. Only the read and update operations are supported on this resource; create and delete are not supported.
+
+## Methods
+
+| Method | Return type | Description |
+| :-- | : | :- |
+| [Get onPremisesDirectorySynchronization](../api/onpremisesdirectorysynchronization-get.md) | [onPremisesDirectorySynchronization](../resources/onpremisesdirectorysynchronization.md) | Read the properties and relationships of an [onPremisesDirectorySynchronization](../resources/onpremisesdirectorysynchronization.md) object. |
+| [Update onPremisesDirectorySynchronization](../api/onpremisesdirectorysynchronization-update.md) | [onPremisesDirectorySynchronization](../resources/onpremisesdirectorysynchronization.md) | Update the properties of an [onPremisesDirectorySynchronization](../resources/onpremisesdirectorysynchronization.md) object. |
+
+## Properties
+
+| Property | Type | Description |
+| : | :-- | : |
+| configuration | [onPremisesDirectorySynchronizationConfiguration](../resources/onpremisesdirectorysynchronizationconfiguration.md) | Consists of configurations that can be fine-tuned and impact the on-premises directory synchronization process for a tenant. |
+| features | [onPremisesDirectorySynchronizationFeature](../resources/onpremisesdirectorysynchronizationfeature.md) | Consists of directory synchronization features that can be enabled or disabled. |
+| id | String | The unique Azure AD tenant ID. |
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.onPremisesDirectorySynchronization",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.onPremisesDirectorySynchronization",
+ "id": "String (identifier)",
+ "configuration": {
+ "@odata.type": "microsoft.graph.onPremisesDirectorySynchronizationConfiguration"
+ },
+ "features": {
+ "@odata.type": "microsoft.graph.onPremisesDirectorySynchronizationFeature"
+ }
+}
+```
v1.0 Onpremisesdirectorysynchronizationconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/onpremisesdirectorysynchronizationconfiguration.md
+
+ Title: "onPremisesDirectorySynchronizationConfiguration resource type"
+description: "Consists of configurations that can be fine-tuned and impact the on-premises directory synchronization process for a tenant."
+
+ms.localizationpriority: medium
++
+# onPremisesDirectorySynchronizationConfiguration resource type
+
+Namespace: microsoft.graph
+
+Consists of configurations that can be fine-tuned and impact the on-premises directory synchronization process for a tenant.
+
+## Properties
+
+| Property | Type | Description |
+| : | :-- | :- |
+| accidentalDeletionPrevention | [onPremisesAccidentalDeletionPrevention](../resources/onpremisesaccidentaldeletionprevention.md) | Contains the accidental deletion prevention configuration for a tenant. |
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.onPremisesDirectorySynchronizationConfiguration"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.onPremisesDirectorySynchronizationConfiguration",
+ "accidentalDeletionPrevention": {
+ "@odata.type": "microsoft.graph.onPremisesAccidentalDeletionPrevention"
+ }
+}
+```
v1.0 Onpremisesdirectorysynchronizationfeature https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/onpremisesdirectorysynchronizationfeature.md
+
+ Title: "onPremisesDirectorySynchronizationFeature resource type"
+description: "Consists of directory synchronization features that can be enabled or disabled."
+
+ms.localizationpriority: medium
++
+# onPremisesDirectorySynchronizationFeature resource type
+
+Namespace: microsoft.graph
+
+Consists of directory synchronization features that can be enabled or disabled. The naming pattern used is `<featureName>Enabled`. `true` indicates that the feature is enabled and `false` indicates that the feature disabled.
+
+## Properties
+
+| Property | Type | Description |
+| :-- | : | :-- |
+| blockCloudObjectTakeoverThroughHardMatchEnabled | Boolean | Used to block cloud object takeover via source anchor hard match if enabled. |
+| blockSoftMatchEnabled | Boolean | Use to block soft match for all objects if enabled for the tenant. Customers are encouraged to enable this feature and keep it enabled until soft matching is required again for their tenancy. This flag should be enabled again after any soft matching has been completed and is no longer needed. |
+| bypassDirSyncOverridesEnabled | Boolean | When `true`, persists the values of _Mobile_ and _OtherMobile_ in on-premises AD during sync cycles instead of values of _MobilePhone_ or _AlternateMobilePhones_ in Azure AD. |
+| cloudPasswordPolicyForPasswordSyncedUsersEnabled | Boolean | Used to indicate that cloud password policy applies to users whose passwords are synchronized from on-premises. |
+| concurrentCredentialUpdateEnabled | Boolean | Used to enable concurrent user credentials update in OrgId. |
+| concurrentOrgIdProvisioningEnabled | Boolean | Used to enable concurrent user creation in OrgId. |
+| deviceWritebackEnabled | Boolean | Used to indicate that device write-back is enabled. |
+| directoryExtensionsEnabled | Boolean | Used to indicate that [directory extensions](/graph/api/resources/extensionProperty) are being synced from on-premises AD to Azure AD. |
+| fopeConflictResolutionEnabled | Boolean | Used to indicate that for a Microsoft Forefront Online Protection for Exchange (FOPE) migrated tenant, the conflicting proxy address should be migrated over. |
+| groupWriteBackEnabled | Boolean | Used to enable object-level group writeback feature for additional group types. |
+| passwordSyncEnabled | Boolean | Used to indicate on-premise password synchronization is enabled. |
+| passwordWritebackEnabled | Boolean | Used to indicate that writeback of password resets from Azure AD to on-premises AD is enabled. |
+| quarantineUponProxyAddressesConflictEnabled | Boolean | Used to indicate that we should quarantine objects with conflicting proxy address. |
+| quarantineUponUpnConflictEnabled | Boolean | Used to indicate that we should quarantine objects conflicting with duplicate userPrincipalName. |
+| softMatchOnUpnEnabled | Boolean | Used to indicate that we should soft match objects based on userPrincipalName. |
+| synchronizeUpnForManagedUsersEnabled | Boolean | Used to indicate that we should synchronize userPrincipalName objects for managed users with licenses. |
+| unifiedGroupWritebackEnabled | Boolean | Used to indicate that Microsoft 365 Group write-back is enabled. |
+| userForcePasswordChangeOnLogonEnabled | Boolean | Used to indicate that feature to force password change for a user on logon is enabled while synchronizing on-premise credentials. |
+| userWritebackEnabled | Boolean | Used to indicate that user writeback is enabled. |
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.onPremisesDirectorySynchronizationFeature"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.onPremisesDirectorySynchronizationFeature",
+ "passwordSyncEnabled": "Boolean",
+ "passwordWritebackEnabled": "Boolean",
+ "directoryExtensionsEnabled": "Boolean",
+ "quarantineUponUpnConflictEnabled": "Boolean",
+ "quarantineUponProxyAddressesConflictEnabled": "Boolean",
+ "softMatchOnUpnEnabled": "Boolean",
+ "cloudPasswordPolicyForPasswordSyncedUsersEnabled": "Boolean",
+ "fopeConflictResolutionEnabled": "Boolean",
+ "unifiedGroupWritebackEnabled": "Boolean",
+ "userWritebackEnabled": "Boolean",
+ "deviceWritebackEnabled": "Boolean",
+ "synchronizeUpnForManagedUsersEnabled": "Boolean",
+ "userForcePasswordChangeOnLogonEnabled": "Boolean",
+ "concurrentOrgIdProvisioningEnabled": "Boolean",
+ "concurrentCredentialUpdateEnabled": "Boolean",
+ "groupWriteBackEnabled": "Boolean",
+ "blockSoftMatchEnabled": "Boolean",
+ "blockCloudObjectTakeoverThroughHardMatchEnabled": "Boolean",
+ "bypassDirSyncOverridesEnabled": "Boolean"
+}
+```
v1.0 Plannerplancontainer https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/plannerplancontainer.md
Microsoft Planner currently supports the container types listed in the following
|Type|Description|Path to the resource| |-|--|--|
-|group| Plan is contained by a [group](group.md).| https://graph.microsoft.com/v1.0/groups/{id}|
-|roster| Plan is contained by a **plannerRoster** | https://graph.microsoft.com/beta/planner/rosters/{id}. Rosters as containers for plans (**plannerRoster** resources) are currently accessible only through the beta endpoint.|
+|group| Plan is contained by a [group](group.md).| `https://graph.microsoft.com/v1.0/groups/{id}`|
+|roster| Plan is contained by a **plannerRoster** | `https://graph.microsoft.com/beta/planner/rosters/{id}`. Rosters as containers for plans (**plannerRoster** resources) are currently accessible only through the beta endpoint.|
## Properties |Property|Type|Description|
v1.0 Search Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/search-api-overview.md
The following table describes the types available to query and the supported per
| EntityType | Permission scope required to access the items| Source| Comment| |:|:|:|:|
+|[chatMessage](chatmessage.md)|Chat.Read, Chat.ReadWrite, ChannelMessage.Read.All|Teams|Teams messages.|
|[message](message.md)|Mail.Read, Mail.ReadWrite| Exchange Online| Email messages.| |[event](event.md) |Calendars.Read, Calendars.ReadWrite| Exchange Online|Calendar events. | |[drive](drive.md)|Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All| SharePoint | Document libraries.|
The search API has the following limitations:
- The **contentSource** property, which defines the connection to use, is only applicable when **entityType** is specified as `externalItem`. -- The search API does not support custom sort for **message**, **event** or **externalItem**.
+- The search API does not support custom sort for **message**, **chatMessage**, **event**, **person**, or **externalItem**.
- The search API does not support aggregations for **message**, **event**, **site** or **drive**. - The search API does not support xrank for **message**,**chatMessage**, **event**, **person**, or **externalItem**. -- Customizations in SharePoint search, such as a custom search schema or result sources, can interfere with the operation of the Microsoft Search API.
+- Customizations in SharePoint search, such as a custom search schema or result sources, can interfere with Microsoft Search API operations.
## See also - Learn more about a few key use cases:
+ - [Search Teams messages](/graph/search-concept-chat-messages)
- [Search Outlook messages](/graph/search-concept-messages) - [Search calendar events](/graph/search-concept-events) - [Search content in SharePoint and OneDrive](/graph/search-concept-files)
The search API has the following limitations:
- [Refine search results](/graph/search-concept-aggregation) - [Request spelling correction](/graph/search-concept-speller) - [Use search display layout](/graph/search-concept-display-layout)
+ - [Search content with application permission](/graph/search-concept-searchall)
- [XRANK search results](/graph/search-concept-xrank) - Explore the search APIs in [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer).
v1.0 Searchrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/searchrequest.md
The JSON blob contains the types of resources expected in the response, the unde
|from|Int32|Specifies the offset for the search results. Offset 0 returns the very first result. Optional.| |query|[searchQuery](searchquery.md)|Contains the query terms. Required.| |queryAlterationOptions|[searchAlterationOptions](searchalterationoptions.md)|Query alteration options formatted in a JSON blob that contains two optional flags related to spelling correction. Optional. |
+|region|String|The geographic location for the search. Required for searches that use application permissions. For details, see [Get the region value](/graph/search-concept-searchall). |
|resultTemplateOptions|[resultTemplateOption](resulttemplateoption.md) collection|Provides the search result template options to render search results from connectors.|
+|sharePointOneDriveOptions|[sharePointOneDriveOptions](sharepointonedriveoptions.md)|Indicates the kind of contents to be searched when a search is performed using application permissions. Optional.|
|size|Int32|The size of the page to be retrieved.The maximum value is 1000. Optional.| |sortProperties|[sortProperty](sortProperty.md) collection|Contains the ordered collection of fields and direction to sort results. There can be at most 5 sort properties in the collection. Optional.|
The following is a JSON representation of the resource.
"from": "Int32", "query": {"@odata.type": "microsoft.graph.searchQuery"}, "queryAlterationOptions": {"@odata.type": "microsoft.graph.searchAlterationOptions"},
+ "region": "String",
"resultTemplateOptions": [{"@odata.type": "microsoft.graph.resultTemplateOption"}],
+ "sharePointOneDriveOptions": {"@odata.type": "microsoft.graph.sharePointOneDriveOptions"},
"size": "Int32" } ```
The following is a JSON representation of the resource.
- Use [aggregations](/graph/search-concept-aggregation) to refine search results - Use [display layout](/graph/search-concept-display-layout.md) - Enable [spell corrections](/graph/search-concept-speller) in search results
+- [Search SharePoint content with application permissions](/graph/search-concept-searchall)
<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
v1.0 Sharepointonedriveoptions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/sharepointonedriveoptions.md
+
+ Title: "sharePointOneDriveOptions resource type"
+description: "Provides the search content options when a search is performed using application permissions."
+ms.localizationpriority: medium
+++
+# sharePointOneDriveOptions resource type
+
+Namespace: microsoft.graph
+
+Provides the search content options when a search is performed using application permissions.
+
+## Properties
+
+| Property | Type | Description |
+|:-|:|:|
+|includeContent|searchContent| The type of search content. The possible values are: `sharedContent`, `privateContent`, `unknownFutureValue`. Read-only. |
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+
+ ],
+ "@odata.type": "microsoft.graph.sharePointOneDriveOptions",
+ "baseType": null
+}-->
+
+```json
+{
+ "includeContent": "string"
+}
+```
v1.0 Shift https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/shift.md
doc_type: resourcePageType
Namespace: microsoft.graph
-Represents a unit of scheduled work in a [schedule](schedule.md).
+Represents a unit of scheduled work in a [schedule](schedule.md).
+
+The duration of a shift cannot be less than 1 minute or longer than 24 hours.
## Methods
v1.0 Skypeforbusinessuserconversationmember https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/skypeforbusinessuserconversationmember.md
+
+ Title: "skypeForBusinessUserConversationMember resource type"
+description: "Represents a Skype for Business user in a chat"
+
+ms.localizationpriority: medium
++
+# skypeForBusinessUserConversationMember resource type
+
+Namespace: microsoft.graph
+
+Represents a Skype for Business user in a chat.
+
+For information about Teams and Skype for Business interoperability, see [Understand Microsoft Teams and Skype for Business coexistence and interoperability](/microsoftteams/teams-and-skypeforbusiness-coexistence-and-interoperability).
+
+Inherits from [conversationMember](../resources/conversationmember.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Display name of the user. Inherited from [conversationMember](../resources/conversationmember.md).|
+|id|String|Membership ID that represents this resource. Inherited from [entity](../resources/entity.md).|
+|roles|String collection|Special roles for this user. Inherited from [conversationMember](../resources/conversationmember.md).|
+|tenantId|String|ID of the tenant that the user belongs to.|
+|userId|String|Azure Active Directory ID of the user.|
+|visibleHistoryStartDateTime|DateTimeOffset|The timestamp denoting how far back a conversation's history is shared with the conversation member. Inherited from [conversationMember](../resources/conversationmember.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.skypeForBusinessUserConversationMember",
+ "baseType": "microsoft.graph.conversationMember",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.skypeForBusinessUserConversationMember",
+ "id": "String (identifier)",
+ "roles": [
+ "String"
+ ],
+ "displayName": "String",
+ "visibleHistoryStartDateTime": "String (timestamp)",
+ "userId": "String",
+ "tenantId": "String"
+}
+```
+
v1.0 Skypeuserconversationmember https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/skypeuserconversationmember.md
+
+ Title: "skypeUserConversationMember resource type"
+description: "Represents a Skype user in a chat"
+
+ms.localizationpriority: medium
++
+# skypeUserConversationMember resource type
+
+Namespace: microsoft.graph
+
+Represents a Skype (consumer) user in a chat.
+
+For information about Teams and Skype for Business interoperability, see [Understand Microsoft Teams and Skype for Business coexistence and interoperability](/microsoftteams/teams-and-skypeforbusiness-coexistence-and-interoperability).
+
+Inherits from [conversationMember](../resources/conversationmember.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Display name of the user. Inherited from [conversationMember](../resources/conversationmember.md).|
+|id|String|Membership ID that represents this resource. Inherited from [entity](../resources/entity.md).|
+|roles|String collection|Special roles for this user. Inherited from [conversationMember](../resources/conversationmember.md).|
+|skypeId|String|Skype ID of the user.|
+|visibleHistoryStartDateTime|DateTimeOffset|The timestamp denoting how far back a conversation's history is shared with the conversation member. Inherited from [conversationMember](../resources/conversationmember.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.skypeUserConversationMember",
+ "baseType": "microsoft.graph.conversationMember",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.skypeUserConversationMember",
+ "id": "String (identifier)",
+ "roles": [
+ "String"
+ ],
+ "displayName": "String",
+ "visibleHistoryStartDateTime": "String (timestamp)",
+ "skypeId": "String"
+}
+```
+
v1.0 Subscription https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/subscription.md
For the possible resource path values for each supported resource, see [Use the
|||| | applicationId | String | Optional. Identifier of the application used to create the subscription. Read-only. | | changeType | String | Required. Indicates the type of change in the subscribed resource that will raise a change notification. The supported values are: `created`, `updated`, `deleted`. Multiple values can be combined using a comma-separated list. <br><br>**Note:** <li> Drive root item and list change notifications support only the `updated` changeType. <li>[User](../resources/user.md) and [group](../resources/user.md) change notifications support `updated` and `deleted` changeType. Use `updated` to receive notifications when user or group is created, updated or soft deleted. Use `deleted` to receive notifications when user or group is permanently deleted. |
-| clientState | String | Optional. Specifies the value of the `clientState` property sent by the service in each change notification. The maximum length is 128 characters. The client can check that the change notification came from the service by comparing the value of the `clientState` property sent with the subscription with the value of the `clientState` property received with each change notification. |
+| clientState | String | Required. Specifies the value of the `clientState` property sent by the service in each change notification. The maximum length is 128 characters. The client can check that the change notification came from the service by comparing the value of the `clientState` property sent with the subscription with the value of the `clientState` property received with each change notification. |
| creatorId | String | Optional. Identifier of the user or service principal that created the subscription. If the app used delegated permissions to create the subscription, this field contains the id of the signed-in user the app called on behalf of. If the app used application permissions, this field contains the id of the service principal corresponding to the app. Read-only. | | encryptionCertificate | String | Optional. A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Optional but required when **includeResourceData** is `true`. | | encryptionCertificateId | String | Optional. A custom app-provided identifier to help identify the certificate needed to decrypt resource data. |
v1.0 Teamsapp https://github.com/microsoftgraph/microsoft-graph-docs/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
- [teamsTab](../resources/teamstab.md) - [App catalog sample (C#)](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/graph-appcatalog-lifecycle/csharp) - [App catalog sample (Node.JS)](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/graph-appcatalog-lifecycle/nodejs)
+- [Teams app catalog lifecycle C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-appcatalog-lifecycle/csharp)
+- [Teams app catalog lifecycle Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-appcatalog-lifecycle/nodejs)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Teamsappinstallation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/teamsappinstallation.md
The following is a JSON representation of the resource.
- [teamsAppDefinition](teamsappdefinition.md) - [teamsTab](../resources/teamstab.md) - [userScopeTeamsAppInstallation](../resources/userscopeteamsappinstallation.md)
+- [Teams app installation lifecycle C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-app-installation-lifecycle/csharp)
+- [Teams app installation lifecycle Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-app-installation-lifecycle/nodejs)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/user.md
This resource supports:
|companyName | String | The company name which the user is associated. This property can be useful for describing the company that an external user comes from. The maximum length is 64 characters.<br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values).| |consentProvidedForMinor|[consentProvidedForMinor](#consentprovidedforminor-values)|Sets whether consent has been obtained for minors. Allowed values: `null`, `Granted`, `Denied` and `NotRequired`. Refer to the [legal age group property definitions](#legal-age-group-property-definitions) for further information. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, and `in`).| |country|String|The country/region in which the user is located; for example, `US` or `UK`. Maximum length is 128 characters. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values).|
-|createdDateTime | DateTimeOffset |The date and time the user was created, in ISO 8601 format and in UTC time. The value cannot be modified and is automatically populated when the entity is created. Nullable. For on-premises users, the value represents when they were first created in Azure AD. Property is `null` for some users created before June 2018 and on-premises users that were synced to Azure AD before June 2018. Read-only. Read-only. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not` , `ge`, `le`, `in`).|
+|createdDateTime | DateTimeOffset |The date and time the user was created, in ISO 8601 format and in UTC time. The value cannot be modified and is automatically populated when the entity is created. Nullable. For on-premises users, the value represents when they were first created in Azure AD. Property is `null` for some users created before June 2018 and on-premises users that were synced to Azure AD before June 2018. Read-only. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not` , `ge`, `le`, `in`).|
| creationType | String | Indicates whether the user account was created through one of the following methods: <br/> <ul><li>As a regular school or work account (`null`). <li>As an external account (`Invitation`). <li>As a local account for an Azure Active Directory B2C tenant (`LocalAccount`). <li>Through self-service sign-up by an internal user using email verification (`EmailVerified`). <li>Through self-service sign-up by an external user signing up through a link that is part of a user flow (`SelfServiceSignUp`).</ul> <br>Read-only.<br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `in`). | |deletedDateTime| DateTimeOffset | The date and time the user was deleted. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`). | |department|String|The name for the department in which the user works. Maximum length is 64 characters. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not` , `ge`, `le`, `in`, and `eq` on `null` values).|
v1.0 Users https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/users.md
The following table lists the sensitive actions on user objects. All users can r
| Update user principal name | userPrincipalName | | Delete or restore users | Not applicable |
-### Who can reset passwords?
+### Who can reset passwords
-In the following table, the columns list the roles that can reset passwords. The rows list the roles for which their password can be reset.
+In the following table, the columns list the roles that can reset passwords and invalidate refresh tokens. The rows list the roles for which their password can be reset.
The following table is for roles assigned at the scope of a tenant. For roles assigned at the scope of an administrative unit, [further restrictions apply](/azure/active-directory/roles/admin-units-assign-roles#roles-that-can-be-assigned-with-administrative-unit-scope).
User<br/>(no admin role) | :heavy_check_mark: | :heavy_check_mark: | :heavy_chec
User<br/>(no admin role, but member or owner of a role-assignable group) | &nbsp; | &nbsp; | &nbsp; | &nbsp; | :heavy_check_mark: | :heavy_check_mark: User Admin | &nbsp; | &nbsp; | &nbsp; | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: Usage Summary Reports Reader | &nbsp; | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:
+All custom roles | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:
\* A Global Administrator cannot remove their own Global Administrator assignment. This is to prevent a situation where an organization has 0 Global Administrators. > [!NOTE]
-> The ability to reset a password includes the ability to update the following sensitive attributes required for [self-service password reset](/azure/active-directory/authentication/concept-sspr-howitworks):
+> The ability to reset a password includes the ability to update the following sensitive properties required for [self-service password reset](/azure/active-directory/authentication/concept-sspr-howitworks):
> - businessPhones > - mobilePhone > - otherMails
-### Who can update sensitive attributes?
+### Who can perform sensitive actions
-Some administrators can update the following sensitive attributes for some users. All users can read these sensitive attributes.
+Some administrators can perform the following sensitive actions for some users. All users can read the sensitive properties.
-- accountEnabled-- businessPhones-- mobilePhone-- onPremisesImmutableId-- otherMails-- passwordProfile-- userPrincipalName
+| Sensitive action | Sensitive property name |
+| | |
+| Disable or enable users | `accountEnabled` |
+| Update business phone | `businessPhones` |
+| Update mobile phone | `mobilePhone` |
+| Update on-premises immutable ID | `onPremisesImmutableId` |
+| Update other emails | `otherMails` |
+| Update password profile | `passwordProfile` |
+| Update user principal name | `userPrincipalName` |
+| Delete or restore users | Not applicable |
-In the following table, the columns list the roles that can update the sensitive attributes. The rows list the roles for which their sensitive attributes can be updated.
+In the following table, the columns list the roles that can perform sensitive actions. The rows list the roles for which the sensitive action can be performed upon.
The following table is for roles assigned at the scope of a tenant. For roles assigned at the scope of an administrative unit, [further restrictions apply](/azure/active-directory/roles/admin-units-assign-roles#roles-that-can-be-assigned-with-administrative-unit-scope).
-Role that sensitive attributes can be updated | Auth Admin | User Admin | Privileged Auth Admin | Global Admin
+Role that sensitive action can be performed upon | Auth Admin | User Admin | Privileged Auth Admin | Global Admin
| | | | Auth Admin | :heavy_check_mark: | &nbsp; | :heavy_check_mark: | :heavy_check_mark: Directory Readers | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:
User<br/>(no admin role) | :heavy_check_mark: | :heavy_check_mark: | :heavy_chec
User<br/>(no admin role, but member or owner of a role-assignable group) | &nbsp; | &nbsp; | :heavy_check_mark: | :heavy_check_mark: User Admin | &nbsp; | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: Usage Summary Reports Reader | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:-
+All custom roles | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:
## Common properties
v1.0 Webhooks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/webhooks.md
In general, subscription operations require read permission to the resource. For
| Delegated - personal Microsoft account | [contact][], [driveItem][], [event][], [list][], [message][], [todoTask][] | | Application | [alert][], [callRecord][], [channel][], [chatMessage][], [contact][], [conversationMember][], [driveItem][], [event][], [group][], [list][], [message][], [printer][], [printTaskDefinition][], [team][], [user][]| - ## See also - [subscription resource type](./subscription.md) - [Training module: Use change notifications and track changes with Microsoft Graph](/training/modules/msgraph-changenotifications-trackchanges) - [Lifecycle notifications](/graph/webhooks-lifecycle)
+- [Change notification C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-change-notification/csharp)
+- [Change notification Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-change-notification/nodejs)
<!-- Links --> [chat]: ./chat.md
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
href: /training/modules/optimize-network-traffic displayName: throttling - name: Change notifications
- items:
- - name: Overview
- href: /graph/api/resources/webhooks?context=graph/api/1.0
- displayName: change notifications, WebHooks, set up notifications for changes in resource data
- - name: Change notifications tutorial
- href: /training/modules/msgraph-changenotifications-trackchanges
- - name: Missing change notifications
- href: /graph/webhooks-lifecycle?context=graph/api/1.0
- - name: Notifications with resource data
- href: /graph/webhooks-with-resource-data?context=graph/api/1.0
- - name: Get notifications delivered different ways
- href: /graph/change-notifications-delivery?context=graph/api/1.0
- - name: Change notifications for cloud printing
- href: /graph/universal-print-webhook-notifications?context=graph/api/1.0
- - name: Change notifications for Microsoft Teams resources
- items:
- - name: Notification types and payloads
- href: /graph/teams-change-notification-in-microsoft-teams-overview?context=graph/api/1.0
- displayName: change notifications, Teams, Microsoft Teams
- - name: Teams and channels
- href: /graph/teams-changenotifications-team-and-channel?context=graph/api/1.0
- - name: Team and channel membership
- href: /graph/teams-changenotifications-teamMembership?context=graph/api/1.0
- - name: Chat and channel messages
- href: /graph/teams-changenotifications-chatmessage?context=graph/api/1.0
- - name: Chat
- href: /graph/teams-changenotifications-chat?context=graph/api/1.0
- - name: Chat membership
- href: /graph/teams-changenotifications-chatMembership?context=graph/api/1.0
- - name: Change notifications for Outlook resources
- href: /graph/outlook-change-notifications-overview?context=graph/api/1.0
+ displayName: change notifications, rich notifications, basic notifications, subscriptions, webhooks, Azure Event Hubs, Azure Event Grids
+ href: /graph/webhooks?context=graph/api/1.0
- name: Change tracking
- items:
- - name: Overview
- href: /graph/delta-query-overview?context=graph/api/1.0
- displayName: Delta query, track changes, change tracking
- - name: Get changes to events (example)
- href: /graph/delta-query-events?context=graph/api/1.0
- - name: Get changes to groups (example)
- href: /graph/delta-query-groups?context=graph/api/1.0
- - name: Get changes to messages (example)
- href: /graph/delta-query-messages?context=graph/api/1.0
- - name: Get changes to users (example)
- href: /graph/delta-query-users?context=graph/api/1.0
+ displayName: delta query
+ href: /graph/delta-query-overview?context=graph/api/1.0
- name: Add custom data displayName: directory extensions, schema extensions, open extensions, extension attributes href: /graph/extensibility-overview?context=graph/api/1.0
items:
- name: Overview href: resources/webhooks.md - name: Subscription
- href: resources/subscription.md
items:
+ - name: Subscription
+ href: resources/subscription.md
+ - name: Change notification collection
+ href: resources/changenotificationcollection.md
- name: List subscription href: api/subscription-list.md - name: Get subscription
items:
href: api/subscribedsku-list.md - name: Get subscribedSku href: api/subscribedsku-get.md
+ - name: On-premises directory synchronization
+ href: resources/onpremisesdirectorysynchronization.md
+ items:
+ - name: Get
+ href: api/onpremisesdirectorysynchronization-get.md
+ - name: Update
+ href: api/onpremisesdirectorysynchronization-update.md
- name: Identity and sign-in items: - name: Authentication methods