| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| beta | Channel Post Members | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-post-members.md | Content-type: application/json #### Request +The following is an example of a request. # [HTTP](#tab/http) <!-- { Content-length: 468 "tenantId": "a18103d1-a6ef-4f66-ac64-e4ef42ea8681" } ```+### Example 6: Add a user who is part of the same or a different tenant as a member to a shared channel using user principal name ++#### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "channel_add_member_6" +} --> +```http +POST https://graph.microsoft.com/beta/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d82/channels/19%3ALpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81%40thread.tacv2/members +Content-type: application/json ++{ + "@odata.type": "#microsoft.graph.aadUserConversationMember", + "roles": [], + "user@odata.bind": "https://graph.microsoft.com/beta/users('jacob@contoso.com')" +} +``` ++#### 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.conversationMember" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('ece6f0a1-7ca4-498b-be79-edf6c8fc4d82')/channels('19%3ALpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81%40thread.tacv2')/members/microsoft.graph.aadUserConversationMember/$entity", + "@odata.type": "#microsoft.graph.aadUserConversationMember", + "id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=", + "roles": [], + "displayName": "Jacob Hancock", + "userId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5", + "email": "jacob@contoso.com", + "tenantId": "a18103d1-a6ef-4f66-ac64-e4ef42ea8681" +} +``` ## See also |
| beta | Channel Post | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-post.md | In the request body, supply a JSON representation of a [channel](../resources/ch ## Response -If successful, this method returns a `201 Created` response code and a [channel](../resources/channel.md) object in the response body for channel with a **membershipType** value of `standard` or `private`. For channel with a **membershipType** value of `shared`, this method return `202 Accepted` response that contains a link to the [teamsAsyncOperation](../resources/teamsasyncoperation.md). +If successful, this method returns a `201 Created` response code and a [channel](../resources/channel.md) object in the response body for a channel with a **membershipType** value of `standard` or `private`. For a channel with a **membershipType** value of `shared`, this method returns a `202 Accepted` response code and a link to the [teamsAsyncOperation](../resources/teamsasyncoperation.md). If the request is unsuccessful, this method returns a `400 Bad Request` response code. The following are common reasons for this response: |
| beta | 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 |:|:|:| |displayName|String|The display name for the provisioning policy. | |description|String|The provisioning policy description.|+|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.| |
| beta | Group Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-update.md | HTTP/1.1 204 No Content #### Request -You can obtain the ID of the label you want to apply to a Microsoft 365 group by using [List label](informationprotectionpolicy-list-labels.md). Then you can update the [assignedLabels](../resources/assignedlabel.md) property of the group with the label ID. +You can obtain the ID of the label you want to apply to a Microsoft 365 group by using [List label](informationprotectionpolicy-list-labels.md). Then you can update the [assignedLabels](../resources/assignedlabel.md) property of the group with the label ID. ++>**Note:** Use of this API to apply sensitivity labels to Microsoft 365 groups is only supported for delegated permission scenarios. # [HTTP](#tab/http) |
| beta | Subscription Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subscription-delete.md | You can subscribe to changes in Outlook **contact**, **event**, or **message** r ### onlineMeetings, presence **onlineMeetings** and **presence** subscriptions require [encryption](/graph/webhooks-with-resource-data) for notifications with resource data. Subscription creation will fail if [encryptionCertificate](../resources/subscription.md) and [encryptionCertificateId](../resources/subscription.md) are not specified if resource data is desired in notifications.+For details about online meeting subscriptions, see [Get change notifications for online meetings](/graph/changenotifications-for-onlinemeeting). ## HTTP request |
| beta | Subscription Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subscription-get.md | You can subscribe to changes in Outlook **contact**, **event**, or **message** r ### onlineMeetings, presence **onlineMeetings** and **presence** subscriptions require [encryption](/graph/webhooks-with-resource-data) for notifications with resource data. Subscription creation will fail if [encryptionCertificate](../resources/subscription.md) and [encryptionCertificateId](../resources/subscription.md) are not specified if resource data is desired in notifications.+For details about online meeting subscriptions, see [Get change notifications for online meetings](/graph/changenotifications-for-onlinemeeting). ## HTTP request |
| beta | Subscription Post Subscriptions | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subscription-post-subscriptions.md | You can subscribe to changes in Outlook **contact**, **event**, or **message** r ### onlineMeetings, presence Subscriptions on **onlineMeetings** and **presence** require the **encryptionCertificate** and **encryptionCertificateId** property when [creating a subscription](/graph/webhooks-with-resource-data#creating-a-subscription) for notifications with encrypted resource data. For more information, see [setting up change notifications to include resource data](/graph/webhooks-with-resource-data).+For details about online meeting subscriptions, see [Get change notifications for online meetings](/graph/changenotifications-for-onlinemeeting). ## HTTP request |
| beta | Subscription Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subscription-update.md | You can subscribe to changes in Outlook **contact**, **event**, or **message** r ### onlineMeetings, presence **onlineMeetings** and **presence** subscriptions require [encryption](/graph/webhooks-with-resource-data) for notifications with resource data. Subscription creation will fail if [encryptionCertificate](../resources/subscription.md) and [encryptionCertificateId](../resources/subscription.md) are not specified if resource data is desired in notifications.+For details about online meeting subscriptions, see [Get change notifications for online meetings](/graph/changenotifications-for-onlinemeeting). ## HTTP request |
| beta | Synchronization Synchronizationjob Provision On Demand | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/synchronization-synchronizationjob-provision-on-demand.md | doc_type: apiPageType Namespace: microsoft.graph -Select a user and provision the account on-demand. +Select a user and provision the account on-demand. The rate limit for this API is 5 requests per 10 seconds. ## 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 } ``` +### Example 3: Provision a group and two of its members on demand ++#### Request ++<!-- { + "blockType": "request", + "name": "synchronizationjob_provisionondemand_Group" +} +--> +``` http +POST https://graph.microsoft.com/beta/servicePrincipals/4e116d82-dd59-4944-824d-93091408fd8d/synchronization/jobs/664ea562-18cd-42bb-33e0-8de1f0560581/provisionOnDemand +Content-Type: application/json ++{ + "parameters": [ + { + "ruleId": "33f7c90d-bf71-41b1-bda6-aaf0ddbee5d8#V2", + "subjects": [ + { + "objectId": "8213fd99-d6b6-417b-8e13-af6334856215", + "objectTypeName": "Group", + "links": { + "members": [ + { + "objectId": "cbc86211-6ada-4803-b73f-8039cf56d8a2", + "objectTypeName": "User" + }, + { + "objectId": "2bc86211-6ada-4803-b73f-8039cf56d8a2", + "objectTypeName": "User" + } + ] + } + } + ] + } + ] +} +``` +++#### Response +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.synchronizationSecretKeyStringValuePair" +} +--> +``` +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://syncfabric.windowsazure.com/api/$metadata#microsoft.synchronization.stringKeyStringValuePair", + "key": "{\"result\":\"Success\",\"details\":{}}", + "value": "{}" +} +``` + |
| beta | 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 [ |:|:|:| |displayName|String|The display name for the provisioning policy.| |description|String|The provisioning policy description.|+|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.| |
| beta | Accessreviewinstancedecisionitem | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/accessreviewinstancedecisionitem.md | Represents an Azure AD [access review](accessreviewsv2-overview.md) decision on |resourceLink|String|A link to the resource. For example, `https://graph.microsoft.com/v1.0/servicePrincipals/c86300f3-8695-4320-9f6e-32a2555f5ff8`. Supports `$select`. Read-only.| |reviewedBy|[userIdentity](../resources/useridentity.md)| The identifier of the reviewer. Supports `$select`. Read-only.| |reviewedDateTime|DateTimeOffset| The timestamp when the review decision occurred. Supports `$select`. Read-only.|+|principalResourceMembership|[decisionItemPrincipalResourceMembership](../resources/decisionItemPrincipalResourceMembership.md)| Every decision item in an access review represents a principal's membership to a resource. This property provides the details of the membership. For example, whether the principal has direct access or indirect access to the resource. Supports `$select`. Read-only.| + ## Relationships The following is a JSON representation of the resource. "resource": { "@odata.type": "microsoft.graph.accessReviewInstanceDecisionItemResource" },+ "principalResourceMembership": { + "@odata.type": "microsoft.graph.decisionItemPrincipalResourceMembership" + }, "resourceLink": "String" } ``` |
| beta | Decisionitemprincipalresourcemembership | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/decisionItemPrincipalResourceMembership.md | + + Title: "decisionItemPrincipalResourceMembership resource type" +description: "Each decision in an access review represents a principal's access to a resource. A decisionItemPrincipalResourceMembership object exposes the details of the type of membership that the principal has to the resource that's associated with the accessReviewInstanceDecisionItem object." ++ms.localizationpriority: medium +++# decisionItemPrincipalResourceMembership resource type ++Namespace: microsoft.graph +++Each decision in an access review represents a principal's access to a resource. A **decisionItemPrincipalResourceMembership** object exposes the details of the type of membership that the principal has to the resource that's associated with the [accessReviewInstanceDecisionItem](accessreviewinstancedecisionitem.md) object. For example, the principal can have direct or indirect access to the resource. +++## Properties +|Property|Type|Description| +|:|:|:| +|membershipType| decisionItemPrincipalResourceMembershipType | Type of membership that the principal has to the resource. Multi-valued. The possible values are: `direct`, `indirect`, `unknownFutureValue`.| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.decisionItemPrincipalResourceMembership", +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.decisionItemPrincipalResourceMembership", + "membershipType": "String", +} +``` |
| beta | Enums | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/enums.md | +### decisionItemPrincipalResourceMembershipType values ++|Member| +|:| +|direct| +|indirect| +|unknownFutureValue| ### signInFrequencyAuthenticationType values |
| beta | Onlinemeeting | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/onlinemeeting.md | Namespace: microsoft.graph Contains information about a meeting, including the URL used to join a meeting, the attendees list, and the description. -This resource supports subscribing to [change notifications](/graph/webhooks). +This resource supports subscribing to [change notifications](/graph/webhooks). See [subscribe to online meetings](/graph/changenotifications-for-onlinemeeting) for more details. ## Methods |
| beta | Synchronization Synchronizationjobsubject | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/synchronization-synchronizationjobsubject.md | Represents the objects that will be provisioned during on-demand provisioning. ## Properties |Property|Type|Description| |:|:|:|+|links|[synchronizationLinkedObjects](../resources/synchronizationlinkedobjects.md)|Principals that you would like to provision.| |objectId|String|The identifier of an object to which a **synchronizationJob** is to be applied. Can be one of the following: <li>An **onPremisesDistinguishedName** for synchronization from Active Directory to Azure AD.</li><li>The user ID for synchronization from Azure AD to a third-party.</li><li>The Worker ID of the Workday worker for synchronization from Workday to either Active Directory or Azure AD.</li>|-|objectTypeName|String|The type of the object to which a **synchronizationJob** is to be applied. Can be one of the following: <li>`user` for synchronization from Active Directory to Azure AD.</li><li>`User` for synchronization from Azure AD to a third-party application. </li><li>`Worker` for synchronization from Workday to either Active Directory or Azure AD.</li>| +|objectTypeName|String|The type of the object to which a **synchronizationJob** is to be applied. Can be one of the following: <li>`user` for synchronizing between Active Directory and Azure AD.</li><li>`User` for synchronizing a user between Azure AD and a third-party application. </li><li>`Worker` for synchronization a user between Workday and either Active Directory or Azure AD.</li><li>`Group` for synchronizing a group between Azure AD and a third-party application. </li>| ## Relationships None. The following is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.synchronizationJobSubject", "objectId": "String",- "objectTypeName": "String" + "objectTypeName": "String", + "links": { + "@odata.type": "microsoft.graph.synchronizationLinkedObjects" + } } ``` |
| beta | Synchronizationlinkedobjects | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/synchronizationlinkedobjects.md | + + Title: "synchronizationLinkedObjects resource type" +description: "Represents any references to be provisioned during on-demand provisioning." ++ms.localizationpriority: medium +++# synchronizationLinkedObjects resource type ++Namespace: microsoft.graph +++Represents any references to be provisioned during on-demand provisioning. ++## Properties +|Property|Type|Description| +|:|:|:| +|members|[synchronizationJobSubject](../resources/synchronization-synchronizationjobsubject.md) collection|All group members that you would like to provision.| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.synchronizationLinkedObjects" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.synchronizationLinkedObjects", + "members": [ + { + "@odata.type": "microsoft.graph.synchronizationJobSubject" + } + ] +} +``` |
| beta | Webhooks | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/webhooks.md | Using the Microsoft Graph API, an app can subscribe to changes on the following | Teams [chat][] | Changes to any chat in the tenant:<br>`/chats` <br>Changes to a specific chat:<br>`/chats/{id}` | Yes | | Teams [chatmessage][] | Changes to chat messages in all channels in all teams:<br>`/teams/getAllMessages` <br>Changes to chat messages in a specific channel:<br>`/teams/{id}/channels/{id}/messages`<br>Changes to chat messages in all chats:<br>`/chats/getAllMessages` <br>Changes to chat messages in a specific chat:<br>`/chats/{id}/messages`<br>Changes to chat messages in all chats a particular user is part of:<br>`/users/{id}/chats/getAllMessages` | Yes | | Teams [conversationMember][] | Changes to membership in a specific team:<br>`/teams/{id}/members` <br> Changes to membership in a specific chat:<br>`/chats/{id}/members` <br> Changes to membership in all chats:<br>`/chats/getAllMembers` <br> Changes to membership in all channels under a specific team:<br>`teams/{id}/channels/getAllMembers` | Yes |-| Teams [onlineMeeting][] | Changes to an online meeting: <br>`/communications/onlinemeeting/{meeting-id}` | Yes | +| Teams [onlineMeeting][] | Changes to an online meeting: <br>`/communications/onlineMeetings/?$filter=JoinWebUrl eq {joinWebUrl}` | Yes | | Teams [presence][] | Changes to a single user's presence: `/communications/presences/{id}` <br> Changes to multiple user presences:<br> `/communications/presences?$filter=id in ({id},{id}...)` | Yes | | Teams [team][] | Changes to any team in the tenant:<br>`/teams` <br>Changes to a specific team:<br>`/teams/{id}` | Yes | | To Do [baseTask][] (deprecated) | Changes to all task in a specific task list:<br>`/me/tasks/lists/{baseTaskListId}/tasks`<br>Changes to all tasks:<br>`/me/tasks/lists/alltasks` | No | In general, subscription operations require read permission to the resource. For [todoTask]: ./todotask.md [To Do task]: ./todotask.md [onlineMeeting]: ./onlinemeeting.md- |