Updates from: 06/30/2021 03:10:48
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accessreviewinstance Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstance-filterbycurrentuser.md
If successful, this function returns a `200 OK` response code and a [accessRevie
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewinstance_filterbycurrentuser"
If successful, this function returns a `200 OK` response code and a [accessRevie
``` http GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/08531375-eff6-4e21-b1a8-de0eb37ec913/instances/filterByCurrentUser(on='reviewer') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Accessreviewinstance List Decisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstance-list-decisions.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_accessreviewinstancedecisionitem"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/16d424f6-0100-4bf1-9ebc-fe009c5e5006/instances/bb14c722-51b8-4962-9bd2-1d96ba773d80/decisions ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstance Resetdecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstance-resetdecisions.md
If successful, this action returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewinstance_resetdecisions"
If successful, this action returns a `204 No Content` response code.
``` http POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/0185aab8-9a7e-44b5-ae36-41b923c3bf87/instances/1234aab8-9a7e-44b5-ae36-41b923c3bf87/resetDecisions ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstancedecisionitem Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstancedecisionitem-filterbycurrentuser.md
If successful, this function returns a `200 OK` response code and a [accessRevie
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewinstancedecisionitem_filterbycurrentuser"
If successful, this function returns a `200 OK` response code and a [accessRevie
``` http GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/0185aab8-9a7e-44b5-ae36-41b923c3bf87/instances/1234aab8-9a7e-5678-ae36-41b923c3bf87/decisions/filterByCurrentUser(on='reviewer') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstancedecisionitem Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewinstancedecisionitem-get.md
If successful, this method returns a `200 OK` response code and an [accessReview
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_accessreviewinstancedecisionitem"
If successful, this method returns a `200 OK` response code and an [accessReview
``` http GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/5eac5a70-7cd7-4f20-92b0-f9dba70dd7f0/instances/6444d4fd-ab55-4608-8cf9-c6702d172bcc/decisions/e6cafba0-cbf0-4748-8868-0810c7f4cc06 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewscheduledefinition Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewscheduledefinition-filterbycurrentuser.md
If successful, this function returns a `200 OK` response code and a [accessRevie
Returns all review definitions where the calling user is a reviewer. ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewscheduledefinition_filterbycurrentuser"
Returns all review definitions where the calling user is a reviewer.
``` http GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/filterByCurrentUser(on='reviewer') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Channel Post Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/channel-post-messages.md
POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5
[!INCLUDE [sample-code](../includes/snippets/objc/post-channelmessage-2-objc-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Java](#tab/java)
+
POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5
[!INCLUDE [sample-code](../includes/snippets/objc/post-channelmessage-3-objc-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Java](#tab/java)
+
v1.0 Chat List Operations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-list-operations.md
If successful, this returns a `200 OK` response code and a collection of [teamsA
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_chat_operations"
If successful, this returns a `200 OK` response code and a collection of [teamsA
``` http GET https://graph.microsoft.com/beta/chats/19:c253a29b5f694b55a6baad8e83510af7@thread.v2/operations ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
v1.0 Chat List Permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-list-permissiongrants.md
Content-type: application/json
## See also - [List permission grants of a team](team-list-permissionGrants.md)-- [List permission grants of a group](group-list-permissionGrants.md)
+- [List permission grants of a group](group-list-permissionGrants.md)
v1.0 Chat Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-post.md
If successful, this method returns a `202 Accepted` response code and Location h
### Example 1: Create a one-on-one chat #### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_chat_oneOnOne"
Content-Type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
Content-Type: application/json
### Example 2: Create a group chat #### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_chat_group"
Content-Type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
Content-Type: application/json
### Example 3: Create a one-on-one chat with installed apps #### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_chat_oneOnOne_with_installed_apps"
Content-Type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
v1.0 Chat Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-sendactivitynotification.md
doc_type: apiPageType
# chat: sendActivityNotification Namespace: microsoft.graph + Send an activity feed notification in scope of a chat. For more details about sending notifications and the requirements for doing so, see [sending Teams activity notifications](/graph/teams-send-activityfeednotifications). ## Permissions
The following table shows the parameters that can be used with this action.
|chainId|Int64|Optional. Used to override a previous notification. Use the same `chainId` in subsequent requests to override the previous notification.| |previewText|[itemBody](../resources/itembody.md)|Preview text for the notification. Microsoft Teams will only show first 150 characters.| |templateParameters|[keyValuePair](../resources/keyvaluepair.md) collection|Values for template variables defined in the activity feed entry corresponding to `activityType` in [Teams app manifest](/microsoftteams/platform/overview).|
-|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. Only Azure AD users are supported. See also [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md). |
+|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. See also [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md) and [chatMembersNotificationRecipient](../resources/chatmembersnotificationrecipient.md). |
The following resources are supported when setting the `source` value of the **topic** property to `entityURL`:
Content-Type: application/json
HTTP/1.1 204 No Content ```
-### Example 2: Notify a user about a approval needed in a chat message
+### Example 2: Notify a user about an approval needed in a chat message
Similar to the previous example, this example uses `entityUrl` for the `topic`. However, in this case, it links to a message in the chat. The message can contains a card with the approval button on it.
Content-Type: application/json
+#### Response
+<!-- {
+ "blockType": "response",
+ "truncated": false
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+### Example 4: Notify the chat members about a task created in a chat
+
+This example shows how you can send an activity feed notification to all chat members. This example is similar to previous examples. However, in this case, the `recipient` is a [chatMembersNotificationRecipient](../resources/chatmembersnotificationrecipient.md). Note that the `chatId` specified in the `recipient` must match the `chatId` specified in the request URL.
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "chat_sendactivitynotification_4"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/chats/19:1c3af46e9e0f4a5293343c8813c47619@thread.v2/sendActivityNotification
+Content-Type: application/json
+
+{
+ "topic": {
+ "source": "entityUrl",
+ "value": "https://graph.microsoft.com/beta/chats/19:1c3af46e9e0f4a5293343c8813c47619@thread.v2"
+ },
+ "activityType": "taskCreated",
+ "previewText": {
+ "content": "New Task Created"
+ },
+ "recipient": {
+ "@odata.type": "microsoft.graph.chatMembersNotificationRecipient",
+ "chatId": "19:1c3af46e9e0f4a5293343c8813c47619@thread.v2"
+ },
+ "templateParameters": [
+ {
+ "name": "taskId",
+ "value": "Task 12322"
+ }
+ ]
+}
+```
+ #### Response <!-- { "blockType": "response",
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessage-post.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/objc/post-chatmessage-2-objc-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Java](#tab/java)
+
v1.0 Cloudpcauditevent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpcauditevent-get.md
+
+ Title: "Get cloudPcAuditEvent"
+description: "Read the properties and relationships of a cloudPcAuditEvent object."
+
+localization_priority: Normal
++
+# Get cloudPcAuditEvent
+
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [cloudPcAuditEvent](../resources/cloudpcauditevent.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/auditEvents/{id}
+```
+
+## 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 [cloudPcAuditEvent](../resources/cloudpcauditevent.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_cloudpcauditevent"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/auditEvents/{id}
+```
+
+### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.cloudPcAuditEvent"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.cloudPcAuditEvent",
+ "id": "250473f5-029f-4037-813d-ba4768201d61",
+ "displayName": "Display Name value",
+ "componentName": "Component Name value",ΓÇ»
+ "activity": "Activity value",ΓÇ»
+ "activityDateTime": "2021-02-14T13:10:51.814636+08:00",ΓÇ»
+ "activityType": " Activity Type value", 
+ "activityOperationType": "Activity Operation Type value",ΓÇ»
+ "activityResult": "Activity Result value",ΓÇ»
+ "correlationId": "a5c71cc6-2271-4d5c-9bfe-d94781e83fe6",ΓÇ»
+ "category": "Category value",
+ "actor": {
+ "@odata.type": "microsoft.graph.cloudPcAuditActor",
+ "type": "Type value",
+ "userPermissions": [
+ "User Permissions value"
+ ],
+ "applicationId": "Application Id value",
+ "applicationDisplayName": "Application Display Name value",
+ "userPrincipalName": "User Principal Name value",
+ "servicePrincipalName": "Service Principal Name value",
+ "ipAddress": "Ip Address value",
+ "userId": "User Id value",
+ "userRoleScopeTags": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcUserRoleScopeTagInfo",
+ "displayName": "Display Name value",
+ "roleScopeTagId": "Role Scope Tag Id value"
+ }
+ ],
+ "remoteTenantId": "Remote Tenant Id value",
+ "remoteUserId": "Remote User Id value"
+ },
+ "resources": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcAuditResource",
+ "displayName": "Display Name value",
+ "modifiedProperties": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcAuditProperty",
+ "displayName": "Display Name value",
+ "oldValue": "Old Value value",
+ "newValue": "New Value value"
+ }
+ ],
+ "type": "Type value",
+ "resourceId": "Resource Id value"
+ }
+ ],
+ }
+}
+```
v1.0 Cloudpcauditevent Getauditactivitytypes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpcauditevent-getauditactivitytypes.md
+
+ Title: "cloudPcAuditEvent: getAuditActivityTypes"
+description: "Get audit activity types by tenant id."
+
+localization_priority: Normal
++
+# cloudPcAuditEvent: getAuditActivityTypes
+
+Namespace: microsoft.graph
++
+Get audit activity types by tenant ID.
++
+## 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/auditEvents/getAuditActivityTypes
+```
+
+## 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 String collection in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "cloudpcauditevent_getauditactivitytypes"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/auditEvents/getAuditActivityTypes
+```
+
+### Response
++
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(Edm.String)"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ "Get Audit Activity Types value"
+ ]
+}
+```
v1.0 Cloudpcusersetting Assign https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpcusersetting-assign.md
If successful, this method returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcusersetting_assign"
Content-length: 254
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Cloudpcusersetting Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpcusersetting-delete.md
If successful, this method returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_cloudpcusersetting"
If successful, this method returns a `204 No Content` response code.
``` http DELETE https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/userSettings/b0c2d35f-3385-46c8-a6f5-6c3dfad7ffff ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Cloudpcusersetting Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpcusersetting-get.md
If successful, this method returns a `200 OK` response code and a [cloudPcUserSe
### Example 1: Get the properties of the specified user setting #### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_cloudpcusersetting"
If successful, this method returns a `200 OK` response code and a [cloudPcUserSe
``` http GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/userSettings/556092f8-92f8-5560-f892-6055f8926055 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-Type: application/json
### Example 2: Get the properties of the specified user setting and expand on the assignments #### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_cloudpcusersetting_2"
Content-Type: application/json
``` http GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/usersettings/b0c2d35f-3385-46c8-a6f5-6c3dfad7ffff?$expand=assignments ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Cloudpcusersetting Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpcusersetting-update.md
If successful, this method returns a `200 OK` response code and an updated [clou
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_cloudpcusersetting"
Content-length: 159
"localAdminEnabled": false } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Directoryrole List Scopedmembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryrole-list-scopedmembers.md
Content-type: application/json
#### Request The following is an example of a request for a directory role with **roleTemplateId** `fdd7a751-b60b-444a-984c-02652fe8fa1c`. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_scopedmembers_directoryrole_templateId"
The following is an example of a request for a directory role with **roleTemplat
```msgraph-interactive GET https://graph.microsoft.com/beta/directoryRoles/roleTemplateId=fdd7a751-b60b-444a-984c-02652fe8fa1c/scopedMembers ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response The following example shows the response.
v1.0 Group List Transitivemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list-transitivemembers.md
Content-type: application/json
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "get_group_transitivemembers_count" }-->
The following is an example of the request.
GET https://graph.microsoft.com/beta/groups/{id}/transitiveMembers/$count ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
The following is an example of the response.
HTTP/1.1 200 OK Content-type: text/plain
+893
```
-`893`
- ### Example 3: Use the microsoft.graph.group OData cast to get only members that are groups
Content-type: text/plain
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_group_transitivemembers_odataCast"
The following is an example of the request.
GET https://graph.microsoft.com/beta/groups/{id}/transitivemembers/microsoft.graph.group?$count=true ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_tier_count"
The following is an example of the request.
GET https://graph.microsoft.com/beta/groups/{id}/transitiveMembers/microsoft.graph.user?$count=true&$orderBy=displayName&$search="displayName:tier"&$select=displayName,id ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_a_count"
The following is an example of the request.
GET https://graph.microsoft.com/beta/groups/{id}/transitiveMembers/microsoft.graph.user?$count=true&$orderBy=displayName&$filter=startswith(displayName, 'a') ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Mobileappmanagementpolicies Delete Includedgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobileappmanagementpolicies-delete-includedgroups.md
If successful, this method returns `204 No Content` response code. It does not r
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_group"
If successful, this method returns `204 No Content` response code. It does not r
```http DELETE https://graph.microsoft.com/beta/policies/mobileAppManagementPolicies/ab90bacf-55a3-4a3e-839a-aa4b74e4f020/includedGroups/1a9db3ab-0acf-4808-99ae-e8ed581cb2e0/$ref ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Mobiledevicemanagementpolicies Delete Includedgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/mobiledevicemanagementpolicies-delete-includedgroups.md
If successful, this method returns a `204 No Content` response code. It does not
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_group"
If successful, this method returns a `204 No Content` response code. It does not
``` http DELETE https://graph.microsoft.com/beta/policies/mobileDeviceManagementPolicies/ab90bacf-55a3-4a3e-839a-aa4b74e4f020/includedGroups/dc3d2ce5-7c5e-4dca-a0ef-2145bf6e53ef/$ref ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Organization Activateservice https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organization-activateservice.md
If successful, this action returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "organization_activateservice"
Content-Type: application/json
"servicePlanId": "a23b959c-7ce8-4e57-9140-b90eb88a9e97" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
Content-Type: application/json
--> ``` http HTTP/1.1 204 No Content
-```
+```
v1.0 Orgcontact Get Transitivereports https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/orgcontact-get-transitivereports.md
If successful, this method returns a `200 OK` response code and a count of trans
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_transitivereports" }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/beta/contacts/45b7d2e7-b882-4a80-ba97-10b7a63b8fa4/transitiveReports/$count ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Presence Clearpresence https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/presence-clearpresence.md
The following request shows the application with ID `22553876-f5ab-4529-bffb-cfe
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "clear--presence"
Content-Type: application/json
"sessionId": "22553876-f5ab-4529-bffb-cfe50aa89f87" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Presence Setpresence https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/presence-setpresence.md
The following request shows the application with ID `22553876-f5ab-4529-bffb-cfe
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "set-presence"
Content-Type: application/json
"expirationDuration": "PT1H" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Serviceannouncement List Healthoverviews https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceannouncement-list-healthoverviews.md
If successful, this method returns a `200 OK` response code and a collection of
### Example 1: Get serviceHealth resources #### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_healthoverviews"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/healthOverviews ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
### Example 2: Include navigation property issues #### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_healthoverviews_with_issues"
Content-Type: application/json
``` http GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/healthOverviews?$expand=issues ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Serviceannouncement List Issues https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceannouncement-list-issues.md
If successful, this method returns a `200 OK` response code and a collection of
## Example ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_servicehealthissue"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/issues ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Serviceannouncement List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceannouncement-list-messages.md
If successful, this method returns a `200 OK` response code and a collection of
## Example ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_serviceupdatemessage"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/messages ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Servicehealth Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/servicehealth-get.md
If successful, this method returns a `200 OK` response code and a [serviceHealth
### Example 1: Get the properties of a serviceHealth object #### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["Microsoft 365 suite"],
If successful, this method returns a `200 OK` response code and a [serviceHealth
``` http GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/healthOverviews/Microsoft 365 suite ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response <!-- {
Content-Type: application/json
### Example 2: Include navigation property issues #### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["Microsoft 365 suite"],
Content-Type: application/json
``` http GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/healthOverviews/Microsoft 365 suite?$expand=issues ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
} ] }
-```
+```
v1.0 Servicehealthissue Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/servicehealthissue-get.md
If successful, this method returns a `200 OK` response code and a [serviceHealth
## Example ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["MO226784"],
If successful, this method returns a `200 OK` response code and a [serviceHealth
``` http GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/issues/MO226784 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Servicehealthissue Incidentreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/servicehealthissue-incidentreport.md
If successful, this function returns a `200 OK` response code and a file stream
## Example ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["MO248163"],
If successful, this function returns a `200 OK` response code and a file stream
``` http GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/issues/MO248163/incidentReport ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Serviceupdatemessage Archive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-archive.md
If successful, this action returns a `200 OK` response code and a Boolean value
## Example ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_archive"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
Content-Type: application/json
{ "value": true }
-```
+```
v1.0 Serviceupdatemessage Favorite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-favorite.md
If successful, this action returns a `200 OK` response code and a Boolean value
## Example ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_favorite"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 Serviceupdatemessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-get.md
If successful, this method returns a `200 OK` response code and a [serviceUpdate
## Example ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["MC172851"],
If successful, this method returns a `200 OK` response code and a [serviceUpdate
``` http GET https://graph.microsoft.com/beta/admin/serviceAnnouncement/messages/MC172851 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
}, "viewPoint": null }
-```
+```
v1.0 Serviceupdatemessage Markread https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-markread.md
If successful, this action returns a `200 OK` response code and a Boolean value
## Example ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_markread"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
Content-Type: application/json
{ "value": true }
-```
+```
v1.0 Serviceupdatemessage Markunread https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-markunread.md
If successful, this action returns a `200 OK` response code and a Boolean value
## Example ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_markunread"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
Content-Type: application/json
{ "value": true }
-```
+```
v1.0 Serviceupdatemessage Unarchive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-unarchive.md
If successful, this action returns a `200 OK` response code and a Boolean value
## Example ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_unarchive"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
Content-Type: application/json
{ "value": true }
-```
+```
v1.0 Serviceupdatemessage Unfavorite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-unfavorite.md
If successful, this action returns a `200 OK` response code and a Boolean value
## Example ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_unfavorite"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
Content-Type: application/json
{ "value": true }
-```
+```
v1.0 Team List Permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-list-permissiongrants.md
If successful, this method returns a `200 OK` response code and a list of [resou
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "team_list_permission_grants"
The following is an example of the request.
```msgraph-interactive GET https://graph.microsoft.com/beta/teams/14c981a4-dca9-4565-bae6-e13ada8861be/permissionGrants ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
Content-type: application/json
## See also - [List permission grants of a group](group-list-permissionGrants.md)-- [List permission grants of a chat](chat-list-permissionGrants.md)
+- [List permission grants of a chat](chat-list-permissionGrants.md)
v1.0 Team Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-sendactivitynotification.md
doc_type: apiPageType
# team: sendActivityNotification Namespace: microsoft.graph + Send an activity feed notification in the scope of a team. For more details about sending notifications and the requirements for doing so, see [sending Teams activity notifications](/graph/teams-send-activityfeednotifications).
The following table shows the parameters that can be used with this action.
|chainId|Int64|Optional. Used to override a previous notification. Use the same `chainId` in subsequent requests to override the previous notification.| |previewText|[itemBody](../resources/itembody.md)|Preview text for the notification. Microsoft Teams will only show first 150 characters.| |templateParameters|[keyValuePair](../resources/keyvaluepair.md) collection|Values for template variables defined in the activity feed entry corresponding to `activityType` in [Teams app manifest](/microsoftteams/platform/overview).|
-|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. Only Azure AD users are supported. See also [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md). |
+|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. See also [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md), [teamMembersNotificationRecipient](../resources/teammembersnotificationrecipient.md), and [channelMembersNotificationRecipient](../resources/channelmembersnotificationrecipient.md). |
The following resources are supported when setting the `source` value of the **topic** property to `entityUrl`:
The following resources are supported when setting the `source` value of the **t
- [chatMesage](../resources/chatmessage.md) - [teamsTab](../resources/teamstab.md)
-> **Note:** The entity url must be same or child resource of the team in the url. Additionally, the [Teams app](/microsoftteams/platform/overview) must be installed in the team.
+> **Note:** The entity URL must be same or child resource of the team in the URL. Additionally, the [Teams app](/microsoftteams/platform/overview) must be installed in the team.
## Response
Content-Type: application/json
+#### Response
+<!-- {
+ "blockType": "response",
+ "truncated": false
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+### Example 4: Notify the team members about pending finance approval requests
+
+This example shows how you can send an activity feed notification to all team members. This example is similar to previous examples. However, in this case, the `recipient` is a [teamMembersNotificationRecipient](../resources/teammembersnotificationrecipient.md). Note that the `teamId` specified in the `recipient` must match the `teamId` specified in the request URL.
+
+> **Note:** The ability to send notifications to all team members is limited to teams with 10,000 members or less. If the team exceeds 10,000 members, none of the team members will receive a notification.
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "team_sendactivitynotification_4"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/teams/e8bece96-d393-4b9b-b8da-69cedef1a7e7/sendActivityNotification
+Content-Type: application/json
+
+{
+ "topic": {
+ "source": "entityUrl",
+ "value": "https://graph.microsoft.com/beta/teams/e8bece96-d393-4b9b-b8da-69cedef1a7e7"
+ },
+ "activityType": "pendingFinanceApprovalRequests",
+ "previewText": {
+ "content": "Internal spending team has a pending finance approval requests"
+ },
+ "recipient": {
+ "@odata.type": "microsoft.graph.teamMembersNotificationRecipient",
+ "teamId": "e8bece96-d393-4b9b-b8da-69cedef1a7e7"
+ },
+ "templateParameters": [
+ {
+ "name": "pendingRequestCount",
+ "value": "5"
+ }
+ ]
+}
+```
+
+#### Response
+<!-- {
+ "blockType": "response",
+ "truncated": false
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+### Example 5: Notify the channel members about pending finance approval requests
+
+This example shows how you can send an activity feed notification to all channel members. This example is similar to the previous example. However, in this case, the `recipient` is a [channelMembersNotificationRecipient](../resources/channelmembersnotificationrecipient.md). Note that the `teamId` specified in the `recipient` must match the `teamId` specified in the request URL.
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "team_sendactivitynotification_5"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/teams/e8bece96-d393-4b9b-b8da-69cedef1a7e7/sendActivityNotification
+Content-Type: application/json
+
+{
+ "topic": {
+ "source": "entityUrl",
+ "value": "https://graph.microsoft.com/beta/teams/e8bece96-d393-4b9b-b8da-69cedef1a7e7"
+ },
+ "activityType": "pendingFinanceApprovalRequests",
+ "previewText": {
+ "content": "Internal spending team has a pending finance approval requests"
+ },
+ "recipient": {
+ "@odata.type": "microsoft.graph.channelMembersNotificationRecipient",
+ "teamId": "e8bece96-d393-4b9b-b8da-69cedef1a7e7",
+ "channelId": "19:3d61a2309f094f4a9310b20f1db37520@thread.tacv2"
+ },
+ "templateParameters": [
+ {
+ "name": "pendingRequestCount",
+ "value": "5"
+ }
+ ]
+}
+```
+ #### Response <!-- { "blockType": "response",
v1.0 Teamsasyncoperation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/teamsasyncoperation-get.md
If successful, this returns a `200 OK` response code and a [teamsAsyncOperation]
## Example: Get operation on chat ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_chat_operation"
If successful, this returns a `200 OK` response code and a [teamsAsyncOperation]
``` http GET https://graph.microsoft.com/beta/chats/19:c253a29b5f694b55a6baad8e83510af7@thread.v2/operations/2432b57b-0abd-43db-aa7b-16eadd115d34-e88ae9aa-887e-4972-ac3e-bd578e38232e-cf58835e-43f0-4fc1-825e-5de55630e7e4 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 Teamworktag Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/teamworktag-delete.md
If successful, this method returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_teamworktag"
If successful, this method returns a `204 No Content` response code.
``` http DELETE https://graph.microsoft.com/beta/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk== ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Teamworktag Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/teamworktag-get.md
If successful, this method returns a `200 OK` response code and a [teamworkTag](
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_teamworktag"
If successful, this method returns a `200 OK` response code and a [teamworkTag](
``` http GET https://graph.microsoft.com/beta/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk== ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Teamworktag List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/teamworktag-list.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_teamworktag"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
GET https://graph.microsoft.com/beta/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "Collection(microsoft.graph.teamworkTag)"
+ "@odata.type": "microsoft.graph.teamworkTag",
+ "isCollection": true
} --> ``` http
HTTP/1.1 200 OK
Content-Type: application/json {
- "value": [
- {
- "@odata.type": "#microsoft.graph.teamworkTag",
- "id": "MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk==",
- "teamId": "53c53217-fe77-4383-bc5a-ed4937a1aecd",
- "displayName": "Finance",
- "description": "Finance Team for Mach 8 Project",
- "memberCount": 2,
- "tagType": "standard"
- },
- {
- "@odata.type": "#microsoft.graph.teamworkTag",
- "id": "MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyNlYjY1M2Y5Mi04MzczLTRkZTYtYmZlYy01YjRkMjE2YjZhZGUjIzk3ZjYyMzQ0LTU3ZGMtNDA5Yy04OGFkLWM0YWYxNDE1OGZmNQ==",
- "teamId": "53c53217-fe77-4383-bc5a-ed4937a1aecd",
- "displayName": "Legal",
- "description": "Legal experts, ask us your legal questions",
- "memberCount": 4,
- "tagType": "standard"
- }
- ]
+ "value":[
+ {
+ "@odata.type":"#microsoft.graph.teamworkTag",
+ "id":"MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk==",
+ "teamId":"53c53217-fe77-4383-bc5a-ed4937a1aecd",
+ "displayName":"Finance",
+ "description":"Finance Team for Mach 8 Project",
+ "memberCount":2,
+ "tagType":"standard"
+ },
+ {
+ "@odata.type":"#microsoft.graph.teamworkTag",
+ "id":"MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyNlYjY1M2Y5Mi04MzczLTRkZTYtYmZlYy01YjRkMjE2YjZhZGUjIzk3ZjYyMzQ0LTU3ZGMtNDA5Yy04OGFkLWM0YWYxNDE1OGZmNQ==",
+ "teamId":"53c53217-fe77-4383-bc5a-ed4937a1aecd",
+ "displayName":"Legal",
+ "description":"Legal experts, ask us your legal questions",
+ "memberCount":4,
+ "tagType":"standard"
+ }
+ ]
} ```
v1.0 Teamworktag Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/teamworktag-post-members.md
If successful, this method returns a `201 Created` response code and a [teamwork
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_teamworktagmember_from_"
Content-length: 144
"userId":"97f62344-57dc-409c-88ad-c4af14158ff5" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Teamworktag Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/teamworktag-post.md
The following table shows the properties that are required when you create the [
|Property|Type|Description| |:|:|:|
-|displayName|String|Name of the tag. The value cannot be more than 40 characters.|
-|members| [teamworkTagMember](../resources/teamworktagmember.md) collection |Members of the team to add to the tag. Set the user identifier property of each member. Members count should not be more than 25.|
+|displayName|String|Name of the tag. The value can't be more than 40 characters.|
+|members| [teamworkTagMember](../resources/teamworktagmember.md) collection |Members of the team to add to the tag. Set the user identifier property of each member. Members count shouldn't be more than 25.|
If successful, this method returns a `201 Created` response code and a [teamwork
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_teamworktag_from"
Content-Type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Teamworktag Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/teamworktag-update.md
The following table shows the properties that are required when you update the [
|Property|Type|Description| |:|:|:|
-|displayName|String|Name of the tag. The value can not be more than 40 characters.|
+|displayName|String|Name of the tag. The value can't be more than 40 characters.|
## Response
If successful, this method returns a `200 OK` response code and an updated [team
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_teamworktag"
Content-length: 185
"displayName": "Finance" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Teamworktagmember Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/teamworktagmember-delete.md
If successful, this method returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_teamworktagmember"
If successful, this method returns a `204 No Content` response code.
``` http DELETE https://graph.microsoft.com/beta/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk==/members/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyNlYjY1M2Y5Mi04MzczLTRkZTYtYmZlYy01YjRkMjE2YjZhZGUjI2QzYjJiM2ViLWM0N2YtNDViOS05NWYyLWIyZjJlZjYyMTVjZQ== ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Teamworktagmember Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/teamworktagmember-get.md
If successful, this method returns a `200 OK` response code and a [teamworkTagMe
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_teamworktagmember"
If successful, this method returns a `200 OK` response code and a [teamworkTagMe
``` http GET https://graph.microsoft.com/beta/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk==/members/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyNlYjY1M2Y5Mi04MzczLTRkZTYtYmZlYy01YjRkMjE2YjZhZGUjI2QzYjJiM2ViLWM0N2YtNDViOS05NWYyLWIyZjJlZjYyMTVjZQ== ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Teamworktagmember List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/teamworktagmember-list.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_teamworktagmember"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk==/members ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
GET https://graph.microsoft.com/beta/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "Collection(microsoft.graph.teamworkTagMember)"
+ "@odata.type": "microsoft.graph.teamworkTagMember",
+ "isCollection": true
} --> ``` http
v1.0 User Get Transitivereports https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-get-transitivereports.md
If successful, this method returns a `200 OK` response code and a count of trans
The following is an example of the request. The `$count` query segment is required. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_transitivereports_user" }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/beta/users/45b7d2e7-b882-4a80-ba97-10b7a63b8fa4/transitiveReports/$count ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 User List Createdobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list-createdobjects.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a list of directory objects that were created by the user.
+Get a list of directory objects that were created by the user. This API returns only those directory objects that were created by a user who isn't in any administrator role; otherwise, it returns an empty 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).
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /users/{id | userPrincipalName}/createdObjects
+GET /me/createdObjects
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [directoryObject](../resources/directoryobject.md) objects in the response body. ## Example ##### Request
-Here is an example of the request.
- # [HTTP](#tab/http) <!-- { "blockType": "request",
GET https://graph.microsoft.com/beta/me/createdObjects
##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+The following is an example of the response. From the response, the user created a Microsoft 365 group, an application, and it's service principal.
+
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 55
{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
"value": [ {
- "id": "id-value"
+ "@odata.type": "#microsoft.graph.group",
+ "id": "92f3d47b-86cc-4b90-953e-8ec7f83ef45f",
+ "displayName": "Contoso volunteer roster",
+ "groupTypes": [
+ "Unified"
+ ],
+ "mail": "volunteers@contoso.com",
+ "mailEnabled": true,
+ "mailNickname": "volunteers"
+ },
+ {
+ "@odata.type": "#microsoft.graph.application",
+ "id": "5847962e-c746-4707-a657-f80b5b71f429",
+ "appId": "254e989a-1b8c-4f8c-84e8-9dea78e9d283",
+ "displayName": "ConVol",
+ "publisherDomain": "contoso.com",
+ "signInAudience": "AzureADMyOrg"
+ },
+ {
+ "@odata.type": "#microsoft.graph.servicePrincipal",
+ "id": "ea6a54da-62be-4cdc-9860-3ed68a43d8f6",
+ "accountEnabled": true,
+ "appDisplayName": "ConVol",
+ "appDescription": null,
+ "appId": "254e989a-1b8c-4f8c-84e8-9dea78e9d283",
+ "displayName": "ConVol",
+ "servicePrincipalNames": [
+ "254e989a-1b8c-4f8c-84e8-9dea78e9d283"
+ ],
+ "servicePrincipalType": "Application",
+ "signInAudience": "AzureADMyOrg",
} ] }
v1.0 User Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-update.md
One of the following permissions is required to call this API. To learn more, in
|Application | User.ReadWrite.All, User.ManageIdentities.All, Directory.ReadWrite.All | >[!NOTE]
-> - When updating the **passwordProfile** property, the following permission is required: Directory.AccessAsUser.All.
+> - When updating the **passwordProfile** property, the following permission is required: *Directory.AccessAsUser.All*.
> - Updating another user's **businessPhones**, **mobilePhone**, or **otherMails** property is only allowed on users who are non-administrators or assigned one of the following roles: Directory Readers, Guest Inviter, Message Center Reader, and Reports Reader. For more details, see Helpdesk (Password) Administrator in [Azure AD built-in roles](/azure/active-directory/roles/permissions-reference). This is the case for apps granted either the User.ReadWrite.All or Directory.ReadWrite.All delegated or application permissions. > - Your personal Microsoft account must be tied to an AAD 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 the response.
HTTP/1.1 204 No Content ```
+### Example 3: Update the passwordProfile of a user to reset their password
+
+The following example shows a request that resets the password of another user.
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "update_user_passwordProfile"
+}-->
+```http
+PATCH https://graph.microsoft.com/beta/users/{id}
+Content-type: application/json
+
+{
+ "passwordProfile": {
+ "forceChangePasswordNextSignIn": false,
+ "password": "xWwvJ]6NMw+bWH-d"
+ }
+}
+```
++
+#### Response
+<!-- {
+ "blockType": "response"
+} -->
+```http
+HTTP/1.1 204 No Content
+```
+ ## See also - [Add custom data to resources using extensions](/graph/extensibility-overview)
v1.0 Userinsightssettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/userinsightssettings-get.md
If successful, this method returns a `200 OK` response code and a [userInsightsS
The following is an example of the request to get user item insights and meeting hours insights settings. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_userInsightsSettings" }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/beta/me/settings/itemInsights ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Userinsightssettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/userinsightssettings-update.md
If successful, this method returns a `200 OK` response code and [userInsightsSet
The following is an example request on how user updates "**isEnabled**" privacy setting in order to disable his item insights and meeting hours insights. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_userInsightsSettings"
Content-type: application/json
"isEnabled": "false" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Virtualendpoint List Auditevents https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/virtualendpoint-list-auditevents.md
+
+ Title: "List auditEvents"
+description: "Get a list of the cloudPcAuditEvent objects and their properties."
+
+localization_priority: Normal
++
+# List auditEvents
+
+Namespace: microsoft.graph
++
+List all the [cloudPcAuditEvent](../resources/cloudpcauditevent.md) objects for 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)|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/auditEvents
+```
+
+## Optional query parameters
+
+This method supports `$skiptoken`, `$top` and `$filter` 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 [cloudPcAuditEvent](../resources/cloudpcauditevent.md) objects in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "list_cloudpcauditevent"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/auditEvents
+```
+
+### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.cloudPcAuditEvent",
+ "isCollection": true
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.cloudPcAuditEvent",
+ "id": "250473f5-029f-4037-813d-ba4768201d61",
+ "displayName": "Display Name value",
+ "componentName": "Component Name value",ΓÇ»
+ "activity": "Activity value",ΓÇ»
+ "activityDateTime": "2021-02-14T13:10:51.814636+08:00",ΓÇ»
+ "activityType": " Activity Type value", 
+ "activityOperationType": "Activity Operation Type value",ΓÇ»
+ "activityResult": "Activity Result value",ΓÇ»
+ "correlationId": "a5c71cc6-2271-4d5c-9bfe-d94781e83fe6",ΓÇ»
+ "category": "Category value",
+ "actor": {
+ "@odata.type": "microsoft.graph.cloudPcAuditActor",
+ "type": "Type value",
+ "userPermissions": [
+ "User Permissions value"
+ ],
+ "applicationId": "Application Id value",
+ "applicationDisplayName": "Application Display Name value",
+ "userPrincipalName": "User Principal Name value",
+ "servicePrincipalName": "Service Principal Name value",
+ "ipAddress": "Ip Address value",
+ "userId": "User Id value",
+ "userRoleScopeTags": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcUserRoleScopeTagInfo",
+ "displayName": "Display Name value",
+ "roleScopeTagId": "Role Scope Tag Id value"
+ }
+ ],
+ "remoteTenantId": "Remote Tenant Id value",
+ "remoteUserId": "Remote User Id value"
+ },
+ "resources": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcAuditResource",
+ "displayName": "Display Name value",
+ "modifiedProperties": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcAuditProperty",
+ "displayName": "Display Name value",
+ "oldValue": "Old Value value",
+ "newValue": "New Value value"
+ }
+ ],
+ "type": "Type value",
+ "resourceId": "Resource Id value"
+ }
+ ],
+ }
+ ]
+}
+```
v1.0 Virtualendpoint List Usersettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/virtualendpoint-list-usersettings.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_cloudpcusersetting"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/userSettings ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Virtualendpoint Post Usersettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/virtualendpoint-post-usersettings.md
If successful, this method returns a `201 Created` response code and a [cloudPcU
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_cloudpcusersetting_from_"
Content-length: 159
"localAdminEnabled": true } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Channelmembersnotificationrecipient https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/channelmembersnotificationrecipient.md
+
+ Title: "channelMembersNotificationRecipient resource type"
+description: Represents the recipient of a notification sent in a Microsoft Teams activity feed. The recipient consists of the channel members.
+
+localization_priority: Normal
++
+# channelMembersNotificationRecipient resource type
+
+Namespace: microsoft.graph
++
+Represents the recipient of a notification sent in a Microsoft Teams activity feed. The recipient consists of the channel members.
+
+Inherits from [teamworkNotificationRecipient](teamworknotificationrecipient.md).
+
+## Properties
+| Property | Type | Description |
+| :-- | :-- | :-- |
+| teamId | String | The team's identifier under which the channel resides. |
+| channelId | String | The channel's identifier. |
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.channelMembersNotificationRecipient"
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.channelMembersNotificationRecipient",
+ "teamId": "String",
+ "channelId": "String"
+}
+```
v1.0 Chatmembersnotificationrecipient https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/chatmembersnotificationrecipient.md
+
+ Title: "chatMembersNotificationRecipient resource type"
+description: Represents the recipient of a notification sent in a Microsoft Teams activity feed. The recipient consists of the chat members.
+
+localization_priority: Normal
++
+# chatMembersNotificationRecipient resource type
+
+Namespace: microsoft.graph
++
+Represents the recipient of a notification sent in a Microsoft Teams activity feed. The recipient consists of the chat members.
+
+Inherits from [teamworkNotificationRecipient](teamworknotificationrecipient.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|chatId|String|The chat's identifier.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.chatMembersNotificationRecipient"
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.chatMembersNotificationRecipient",
+ "chatId": "String"
+}
+```
+
v1.0 Cloudpcauditactor https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpcauditactor.md
+
+ Title: "cloudPcAuditActor resource type"
+description: "The audit actor represented by the Azure AD user and application associated with the audit event."
+
+localization_priority: Normal
++
+# cloudPcAuditActor resource type
+
+Namespace: microsoft.graph
++
+The audit actor represented by the Azure AD user and application associated with the audit event.
++
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|type|[cloudPcAuditActorType](#cloudpcauditactortype-values)|The actor type. Possible values include `ItPro`, `Application`, `Partner` and `Unknown`.|
+|userPermissions|String collection|List of user permissions and application permissions when the audit event was performed.|
+|applicationId|String|Azure AD application ID.|
+|applicationDisplayName|String|Name of the application.|
+|userPrincipalName|String|User Principal Name (UPN).|
+|servicePrincipalName|String|Service Principal Name (SPN).|
+|ipAddress|String|IP address.|
+|userId|String|Azure AD user ID.|
+|userRoleScopeTags|[cloudPcUserRoleScopeTagInfo](../resources/cloudpcuserrolescopetaginfo.md) collection|List of role scope tags.|
+|remoteTenantId|String|The delegated partner tenant ID.|
+|remoteUserId|String|The delegated partner user ID.|
+
+### cloudPcAuditActorType values
+
+|Member|Description|
+|:|:|
+|itPro|The operation was performed by an IT pro.|
+|application|The operation was performed by the application.|
+|partner|The operation was performed by a partner.|
+|unknown|Unknown actor.|
+
+## Relationships
+
+None.
+
+## JSON Representation
+
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.cloudPcAuditActor"
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcAuditActor",
+ "type": "String",
+ "userPermissions": [
+ "String"
+ ],
+ "applicationId": "String",
+ "applicationDisplayName": "String",
+ "userPrincipalName": "String",
+ "servicePrincipalName": "String",
+ "ipAddress": "String",
+ "userId": "String",
+ "userRoleScopeTags": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcUserRoleScopeTagInfo",
+ "displayName": "String",
+ "roleScopeTagId": "String"
+ }
+ ],
+ "remoteTenantId": "String",
+ "remoteUserId": "String"
+}
+```
v1.0 Cloudpcauditevent https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpcauditevent.md
+
+ Title: "cloudPcAuditEvent resource type"
+description: "Represents the audit event entity."
+
+localization_priority: Normal
++
+# cloudPcAuditEvent resource type
+
+Namespace: microsoft.graph
++
+Represents the audit event entity.
++
+## Methods
+
+|Method|Return type|Description|
+|:|:|:|
+|[List auditEvents](../api/virtualendpoint-list-auditevents.md)|[cloudPcAuditEvent](../resources/cloudpcauditevent.md) collection|List all the [cloudPcAuditEvent](../resources/cloudpcauditevent.md) objects in a tenant.|
+|[Get cloudPcAuditEvent](../api/cloudpcauditevent-get.md)|[cloudPcAuditEvent](../resources/cloudpcauditevent.md)|Read the properties and relationships of a [cloudPcAuditEvent](../resources/cloudpcauditevent.md) object.|
+|[getAuditActivityTypes function](../api/cloudpcauditevent-getauditactivitytypes.md)|String collection|Get audit activity types.|
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|Key of the audit entity. Read-only.|
+|displayName|String|Event display name. Read-only.|
+|componentName|String|Component name. Read-only.|
+|actor|[cloudPcAuditActor](../resources/cloudpcauditactor.md)|Azure AD user and application associated with the audit event. Read-only.|
+|activity|String|Friendly name of the activity. Optional.|
+|activityDateTime|DateTimeOffset|The date time in UTC when the activity was performed. Read-only.|
+|activityType|String|The type of activity that was performed. Read-only.|
+|activityOperationType|[cloudPcAuditActivityOperationType](#cloudpcauditactivityoperationtype-values)|The HTTP operation type of the activity. Possible values includeΓÇ»`create`, `delete`, `patch` and `other`. Read-only.|
+|activityResult|[cloudPcAuditActivityResult](#cloudpcauditactivityresult-values)|The result of the activity. Read-only.|
+|correlationId|String|The client request identifier, used to correlate activity within the system. Read-only.|
+|resources|[cloudPcAuditResource](../resources/cloudpcauditresource.md) collection|List of cloudPcAuditResource objects. Read-only.|
+|category|[cloudPcAuditCategory](#cloudpcauditcategory-values)|Audit category. Read-only.|
+
+### cloudPcAuditActivityOperationType values
+
+|Member|Description|
+|:|:|
+|create|Create operation.|
+|delete|Delete operation.|
+|patch|Patch operation.|
+|other|Other operation.|
+
+### cloudPcAuditActivityResult values
+
+|Member|Description|
+|:|:|
+|success|Operation succeeded.|
+|clientError|Operation failed with client error.|
+|failure|Operation failed.|
+|timeExceeded|Operation failed with timeout.|
+|other|Other result.|
+
+### cloudPcAuditCategory values
+
+|Member|Description|
+|:|:|
+|cloudPC|Cloud PC category.|
+|other |Other category.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.cloudPcAuditEvent",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcAuditEvent",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "componentName": "String",
+ "actor": {
+ "@odata.type": "microsoft.graph.cloudPcAuditActor",
+ "type": "String",
+ "userPermissions": [
+ "String"
+ ],
+ "applicationId": "String",
+ "applicationDisplayName": "String",
+ "userPrincipalName": "String",
+ "servicePrincipalName": "String",
+ "ipAddress": "String",
+ "userId": "String",
+ "userRoleScopeTags": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcUserRoleScopeTagInfo",
+ "displayName": "String",
+ "roleScopeTagId": "String"
+ }
+ ],
+ "remoteTenantId": "String",
+ "remoteUserId": "String"
+ },
+ "activity": "String",
+ "activityDateTime": "String (timestamp)",
+ "activityType": "String",
+ "activityOperationType": "String",
+ "activityResult": "String",
+ "correlationId": "String",
+ "resources": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcAuditResource",
+ "displayName": "String",
+ "modifiedProperties": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcAuditProperty",
+ "displayName": "String",
+ "oldValue": "String",
+ "newValue": "String"
+ }
+ ],
+ "type": "String",
+ "resourceId": "String"
+ }
+ ],
+ "category": "String"
+}
+```
v1.0 Cloudpcauditproperty https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpcauditproperty.md
+
+ Title: "cloudPcAuditProperty resource type"
+description: "Represents the audit property. This shows the edited property name, the old value, and the new value."
+
+localization_priority: Normal
++
+# cloudPcAuditProperty resource type
+
+Namespace: microsoft.graph
++
+Represents the audit property. This shows the edited property name, the old value, and the new value.
++
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Display name.|
+|oldValue|String|Old value.|
+|newValue|String|New value.|
+
+## Relationships
+
+None.
+
+## JSON Representation
+
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.cloudPcAuditProperty"
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcAuditProperty",
+ "displayName": "String",
+ "oldValue": "String",
+ "newValue": "String"
+}
+```
v1.0 Cloudpcauditresource https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpcauditresource.md
+
+ Title: "cloudPcAuditResource resource type"
+description: "Represents the audit resource. This shows the target edited resource entity, with multiple edited properties."
+
+localization_priority: Normal
++
+# cloudPcAuditResource resource type
+
+Namespace: microsoft.graph
++
+Represents the audit resource. This shows the target edited resource entity, with multiple edited properties.
++
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The resource entity display name.|
+|modifiedProperties|[cloudPcAuditProperty](../resources/cloudpcauditproperty.md) collection|A list of modified properties.|
+|type|String|The type of the audit resource.|
+|resourceId|String|The ID of the audit resource.|
+
+## Relationships
+
+None
+
+## JSON Representation
+
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.cloudPcAuditResource"
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcAuditResource",
+ "displayName": "String",
+ "modifiedProperties": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcAuditProperty",
+ "displayName": "String",
+ "oldValue": "String",
+ "newValue": "String"
+ }
+ ],
+ "type": "String",
+ "resourceId": "String"
+}
+```
v1.0 Cloudpcuserrolescopetaginfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpcuserrolescopetaginfo.md
+
+ Title: "cloudPcUserRoleScopeTagInfo resource type"
+description: "Represents the scope tag info with display name and identity."
+
+localization_priority: Normal
++
+# cloudPcUserRoleScopeTagInfo resource type
+
+Namespace: microsoft.graph
++
+Represents the scope tag info with display name and identity.
++
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Scope tag display name.|
+|roleScopeTagId|String|Scope tag ID.|
+
+## Relationships
+
+None
+
+## JSON Representation
+Here is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.cloudPcUserRoleScopeTagInfo"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcUserRoleScopeTagInfo",
+ "displayName": "String",
+ "roleScopeTagId": "String"
+}
+```
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/enums.md
Possible values for user account types (group membership), per Windows definitio
|principal| |unknownFutureValue|
+### cloudPcAuditActivityOperationType values
+
+|Member|
+|:|
+|create|
+|delete|
+|patch|
+|other|
+
+### cloudPcAuditActivityResult values
+
+|Member|
+|:|
+|success|
+|clientError|
+|failure|
+|timeout|
+|other|
+
+### cloudPcAuditActorType values
+
+|Member|
+|:|
+|itPro|
+|application|
+|partner|
+|unknown|
+
+### cloudPcAuditCategory values
+
+|Member|
+|:|
+|cloudPC|
+|other|
+ ### postType values |Member|
v1.0 Passwordprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/passwordprofile.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Contains the password profile associated with a user. The **passwordProfile** property of the [user](user.md) entity is a **passwordProfile** object.
+Contains the password profile associated with a user. The **passwordProfile** property of the [user](user.md) entity is a **passwordProfile** object. See an example to [Update the passwordProfile of a user](../api/user-update.md#example-3-update-the-passwordprofile-of-a-user-to-reset-their-password).
## Properties
v1.0 Resulttemplate https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/resulttemplate.md
+
+ Title: "resultTemplate resource type"
+description: "A dictionary of resultTemplateIds and associated values, which include the name and JSON schema of the result templates."
+localization_priority: Normal
+++
+# resultTemplate resource type
+
+Namespace: microsoft.graph
++
+A dictionary of **resultTemplateIds** and associated values, which includes the name and JSON schema of the result templates.
+
+## Properties
+
+| Property | Type | Description |
+|:-|:|:|
+|key|String|ID of a result template. It must map to a **resultTemplateId** in the [searchHit](searchhit.md).|
+|displayName|String|Name of the result template.|
+|body|Json|JSON schema of the result template.|
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+
+ ],
+ "@odata.type": "microsoft.graph.resultTemplate",
+ "baseType": null
+}-->
++
+```json
+{
+ "resultTemplateId": {
+ "displayName": "String",
+ "body": "Json schema"
+ }
+}
+```
++
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "resultTemplate resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
++
v1.0 Resulttemplateoption https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/resulttemplateoption.md
+
+ Title: "resultTemplateOption resource type"
+description: "Provides the search display layouts options for render connectors search results."
+localization_priority: Normal
+++
+# resultTemplateOption resource type
+
+Namespace: microsoft.graph
++
+Provides the search result templates options for render connectors search results.
+
+## Properties
+
+| Property | Type | Description |
+|:-|:|:|
+|enableResultTemplate|Boolean|Indicates whether search display layouts are enabled. If enabled, the user will get the result template to render the search results content in the **resultTemplates** property of the [response](/graph/api/resources/searchresponse?view=graph-rest-beta&preserve-view=true). The result template is based on [Adaptive Cards](https://adaptivecards.io/). This property is optional.|
++
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+
+ ],
+ "@odata.type": "microsoft.graph.resultTemplateOption",
+ "baseType": null
+}-->
+
+```json
+ {
+ "enableResultTemplate": true
+ }
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "resultTemplateOption resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
v1.0 Search Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/search-api-overview.md
Search requests run on behalf of the user. Search results are scoped to enforce
|[Refine results using aggregations](#refine-results-using-aggregations)| **aggregations** | |[Search custom types imported using connectors](/graph/search-concept-custom-types)| **contentSources** | |[Request spelling correction](#request-spelling-correction)| **queryAlterationOptions** |
+|[Search display layout](#search-display-layout) (preview)| **resultTemplateOptions**
## Scope search based on entity types
In the request body of the [query](/graph/api/search-query?view=graph-rest-beta&
For examples that show how to use spelling corrections, see [Request spelling correction](/graph/search-concept-speller).
+## Search display layout
+
+The search API allows you to render search results from [connectors](/microsoftsearch/connectors-overview), by using the display layout or result template configured by the IT admin for each connector. The result templates are [Adaptive Cards](https://adaptivecards.io/), which are a semantically meaningful combination of layout and data.
+
+To get the result template in the [searchresponse](searchresponse.md), you have to set **true** the **enableResultTemplate** property, defined in the [resultTemplateOptions](./resulttemplateoption.md), in the [searchRequest](./searchrequest.md). The response includes a **resultTemplateId** for every [search hit](./searchhit.md), which maps to one of the display layouts included in the **resultTemplates** dictionary that is included in the response.
+
+See [Use search display layout](/graph/search-concept-display-layout) for examples.
+ ## Error handling The search API returns error responses as defined by [OData error object definition](http://docs.oasis-open.org/odata/odata-json-format/v4.01/cs01/odata-json-format-v4.01-cs01.html#sec_ErrorResponse), each of which is a JSON object containing a code and a message.
For backward compatibility, the original properties and types are accessible and
- [Sort search results](/graph/search-concept-sort) - [Refine search results](/graph/search-concept-aggregation) - [Request spelling correction](/graph/search-concept-speller)
+ - [Use search display layout](/graph/search-concept-display-layout)
- Explore the search APIs in [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer).
v1.0 Searchhit https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/searchhit.md
Represents a single result within the list of search results.
|rank|Int32|The rank or the order of the result.| |contentSource|String|The name of the content source which the **externalItem** is part of .| |summary|String|A summary of the result, if a summary is available.|
+|resultTemplateId|String|ID of the result template for rendering the search result. This ID must map to a display layout in the **resultTemplates** dictionary, included in the [searchresponse](searchresponse.md) as well.|
|resource|[entity](entity.md)|The underlying Microsoft Graph representation of the search result.| |_id (deprecated)|String| Renamed as **hitId**. The internal identifier for the item.| |_score (deprecated)|Int32|Renamed as **rank**. The score or the order of the result.|
The following is a JSON representation of the resource.
"hitId": "String", "rank": 1, "summary": "String",
+ "resultTemplateId": "String",
"contentSource": "String", "resource": { "@odata.type": "microsoft.graph.entity" }, "_id": "String",
v1.0 Searchrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/searchrequest.md
The JSON blob contains the types of resources expected in the response, the unde
> [!NOTE] > Be aware of [known limitations](search-api-overview.md#known-limitations) on searching specific combinations of entity types, and sorting or aggregating search results. - ## Properties
-| Property | Type | Description |
-|:-|:|:|:|
+| Property | Type | Description
+|:-|:|:
|aggregations|[aggregationOption](aggregationOption.md) collection|Specifies aggregations (also known as refiners) to be returned alongside search results. Optional.| |aggregationFilters|String collection|Contains one or more filters to obtain search results aggregated and filtered to a specific value of a field. Optional.<br>Build this filter based on a prior search that aggregates by the same field. From the response of the prior search, identify the [searchBucket](searchBucket.md) that filters results to the specific value of the field, use the string in its **aggregationFilterToken** property, and build an aggregation filter string in the format **"{field}:\\"{aggregationFilterToken}\\""**. <br>If multiple values for the same field need to be provided, use the strings in its **aggregationFilterToken** property and build an aggregation filter string in the format **"{field}:or(\\"{aggregationFilterToken1}\\",\\"{aggregationFilterToken2}\\")"**. <br>For example, searching and aggregating drive items by file type returns a **searchBucket** for the file type `docx` in the response. You can conveniently use the **aggregationFilterToken** returned for this **searchBucket** in a subsequent search query and filter matches down to drive items of the `docx` file type. [Example 1](/graph/search-concept-aggregation#example-1-request-aggregations-by-string-fields) and [example 2](/graph/search-concept-aggregation#example-2-apply-an-aggregation-filter-based-on-a-previous-request) show the actual requests and responses.| |contentSources|String collection|Contains the connection to be targeted. <br>Respects the following format : `/external/connections/connectionid` where `connectionid` is the ConnectionId defined in the Connectors Administration. <br> Note: contentSource is only applicable when entityType=`externalItem`. Optional.|
The JSON blob contains the types of resources expected in the response, the unde
|size|Int32|The size of the page to be retrieved. 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.| |stored_fields (deprecated)|String collection |This is now replaced by the **fields** property. |
+|resultTemplateOptions|[resultTemplateOption](resultTemplateOption.md) collection|Provides the search result templates options for rendering connectors search results.|
## JSON representation
The following is a JSON representation of the resource.
"sortProperties": [{"@odata.type": "microsoft.graph.sortProperty"}], "aggregations": [{"@odata.type": "microsoft.graph.aggregationOption"}], "aggregationFilters": ["String"],
- "enableTopResults": true
+ "enableTopResults": true,
+ "resultTemplateOptions": [{"@odata.type": "microsoft.graph.resultTemplateOption"}]
} ```
The following is a JSON representation of the resource.
- Search [mail messages](/graph/search-concept-messages) - Search [calendar events](/graph/search-concept-events) - Search content in SharePoint and OneDrive ([files, lists and sites](/graph/search-concept-files))-- Search [custom types imported using connectors)](/graph/search-concept-custom-types) data
+- Search [custom types imported using connectors](/graph/search-concept-custom-types) data
- [Sort](/graph/search-concept-sort) search results - Use [aggregations](/graph/search-concept-aggregations) to refine search results
+- Use [display layout](/graph/search-concept-display-layout.md)
<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
v1.0 Searchresultset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/searchresultset.md
Represents results from a search query, and the terms used for the query.
|:-|:|:| |hitsContainers|[searchHitsContainer](searchhitscontainer.md) collection|A collection of search results.| |searchTerms|String collection|Contains the search terms sent in the initial search query.|
+|resultTemplates|[resultTemplate](resultTemplate.md) collection|A dictionary of resultTemplateIds and associated values, which include the name and JSON schema of the result templates.
## JSON representation
The following is a JSON representation of the resource.
```json { "hitsContainers": [{"@odata.type": "microsoft.graph.searchHitsContainer"}],
- "searchTerms": ["String"]
+ "searchTerms": ["String"],
+ "resultTemplates": [{"@odata.type":"microsoft.graph.resultTemplateDictionary"}]
} ```
v1.0 Teammembersnotificationrecipient https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/teammembersnotificationrecipient.md
+
+ Title: "teamMembersNotificationRecipient resource type"
+description: Represents the recipient of a notification sent in a Microsoft Teams activity feed. The recipient consists of the team members.
+
+localization_priority: Normal
++
+# teamMembersNotificationRecipient resource type
+
+Namespace: microsoft.graph
++
+Represents the recipient of a notification sent in a Microsoft Teams activity feed. The recipient consists of the team members.
+
+Inherits from [teamworkNotificationRecipient](teamworknotificationrecipient.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|teamId|String|The team's identifier.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.teamMembersNotificationRecipient"
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.teamMembersNotificationRecipient",
+ "teamId": "String"
+}
+```
+
v1.0 Teamworknotificationrecipient https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/teamworknotificationrecipient.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents the recipient of a notification sent in a Microsoft Teams activity feed. See also [aadUserNotificationRecipient](aadusernotificationrecipient.md).
+Represents the recipient of a notification sent in a Microsoft Teams activity feed. See also [aadUserNotificationRecipient](aadusernotificationrecipient.md), [teamMembersNotificationRecipient](teammembersnotificationrecipient.md), [channelMembersNotificationRecipient](channelmembersnotificationrecipient.md), and [chatMembersNotificationRecipient](chatmembersnotificationrecipient.md).
## Properties None.
v1.0 Virtualendpoint https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/virtualendpoint.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The virtualEndpoint resource represents a container for APIs to manage cloud PC.
+Represents a container for APIs to manage cloud PC.
Use the cloud PC API to provision and manage virtual desktops for employees in an organization. Use it in conjunction with the [Intune API](../resources/intune-graph-overview.md) to manage physical and virtual endpoints.
Use the cloud PC API to provision and manage virtual desktops for employees in a
|[Create cloudPcProvisioningPolicy](../api/virtualendpoint-post-provisioningpolicies.md)|[cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md)|Create a new [cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) object.| |[List userSettings](../api/virtualendpoint-list-usersettings.md)|[cloudPcUserSetting](../resources/cloudpcusersetting.md) collection|Get the cloudPcUserSetting resources from the userSettings navigation property.| |[Create cloudPcUserSetting](../api/virtualendpoint-post-usersettings.md)|[cloudPcUserSetting](../resources/cloudpcusersetting.md)|Create a new cloudPcUserSetting object.|
+|[List auditEvents](../api/virtualendpoint-list-auditevents.md)|[cloudPcAuditEvent](../resources/cloudpcauditevent.md) collection|List properties and relationships of the [cloudPcAuditEvent](../resources/cloudpcauditevent.md) objects.|
## Properties
Use the cloud PC API to provision and manage virtual desktops for employees in a
|onPremisesConnections|[cloudPcOnPremisesConnection](../resources/cloudpconpremisesconnection.md) collection|A defined collection of Azure resource information that can be used to establish on-premises network connectivity for cloud PCs.| |provisioningPolicies|[cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md) collection|Cloud PC provisioning policy.| |userSettings|[cloudPcUserSetting](../resources/cloudpcusersetting.md) collection|Cloud PC user settings. |
+|auditEvents|[cloudPcAuditEvent](../resources/cloudpcauditevent.md) collection|Cloud PC audit event.|
## JSON representation
v1.0 Accessreviewinstance Acceptrecommendations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstance-acceptrecommendations.md
If successful, this action returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewinstance_acceptrecommendations"
If successful, this action returns a `204 No Content` response code.
``` http POST https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/e6cafba0-cbf0-4748-8868-0810c7f4cc06/instances/1234fba0-cbf0-5678-8868-0810c7f91006/acceptRecommendations ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstance Applydecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstance-applydecisions.md
If successful, this action returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewinstance_applydecisions"
If successful, this action returns a `204 No Content` response code.
``` http POST https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/e6cafba0-cbf0-4748-8868-0810c7f4cc06/instances/1234fba0-cbf0-5678-8868-0810c7f49101/applyDecisions ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstance Batchrecorddecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstance-batchrecorddecisions.md
If successful, this action returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewinstance_batchrecorddecisions"
Content-type: application/json
"resourceId": "a5c51e59-3fcd-4a37-87a1-835c0c21488a" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 Accessreviewinstance Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstance-filterbycurrentuser.md
If successful, this function returns a `200 OK` response code and a [accessRevie
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewinstance_filterbycurrentuser"
If successful, this function returns a `200 OK` response code and a [accessRevie
``` http GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/e6cafba0-cbf0-4748-8868-0810c7f4cc06/instances/filterByCurrentUser(on='reviewer') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstance Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstance-get.md
If successful, this method returns a `200 OK` response code and an [accessReview
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_accessreviewinstance"
If successful, this method returns a `200 OK` response code and an [accessReview
``` http GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/e6cafba0-cbf0-4748-8868-0810c7f4cc06/instances/12345ba0-cbf0-5678-8868-4444c7f4cc06 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstance List Decisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstance-list-decisions.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_accessreviewinstancedecisionitem"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/2dca8959-b716-4b4c-a93d-a535c01eb6e0/instances/8d035c9d-798d-47fa-beb4-f986a4b8126f/decisions ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstance List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstance-list.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_accessreviewinstance"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/8564a649-4f67-4e09-88e7-55def6530e88/instances ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstance Resetdecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstance-resetdecisions.md
If successful, this action returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewinstance_resetdecisions"
If successful, this action returns a `204 No Content` response code.
``` http POST https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/8564a649-4f67-4e09-88e7-55def6530e88/instances/1234a649-4f67-1234-88e7-55def6530e88/resetDecisions ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstance Sendreminder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstance-sendreminder.md
If successful, this action returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewinstance_sendreminder"
If successful, this action returns a `204 No Content` response code.
``` http POST https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/8564a649-4f67-4e09-88e7-55def6530e88/instances/1234a649-4f67-1234-88e7-55def6530e88/sendReminder ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstance Stop https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstance-stop.md
If successful, this action returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewinstance_stop"
If successful, this action returns a `204 No Content` response code.
``` http POST https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/8564a649-4f67-4e09-88e7-55def6530e88/instances/1234a649-4f67-1234-88e7-55def6530e88/stop ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstancedecisionitem Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstancedecisionitem-filterbycurrentuser.md
If successful, this function returns a `200 OK` response code and a [accessRevie
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewinstancedecisionitem_filterbycurrentuser"
If successful, this function returns a `200 OK` response code and a [accessRevie
``` http GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/1234ea1c-8d12-457b-1234-a37dc59e54e0/instances/7070ea1c-8d12-457b-bd35-a37dc59e54e0/decisions/filterByCurrentUser(on='reviewer') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstancedecisionitem Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstancedecisionitem-get.md
If successful, this method returns a `200 OK` response code and an [accessReview
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_accessreviewinstancedecisionitem"
If successful, this method returns a `200 OK` response code and an [accessReview
``` http GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/abadf3b6-8ea4-4dea-90a5-9eac8fe93fbd/instances/abadf3b6-8ea4-4dea-90a5-9eac8fe93fbd/decisions/9550e25b-f315-4454-9d87-16b885c35de4 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstancedecisionitem List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstancedecisionitem-list.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_accessreviewinstancedecisionitem"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/abadf3b6-8ea4-4dea-90a5-9eac8fe93fbd/instances/7070ea1c-8d12-457b-bd35-a37dc59e54e0/decisions ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewinstancedecisionitem Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewinstancedecisionitem-update.md
If successful, this method returns a `204 OK` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_accessreviewinstancedecisionitem"
Content-length: 691
"justification": "Kathleen still needs access to the Marketing group as she works in the Marketing organization." } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewscheduledefinition Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewscheduledefinition-delete.md
If successful, this method returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_accessreviewscheduledefinition"
If successful, this method returns a `204 No Content` response code.
``` http DELETE https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/3856fd6f-36e2-4152-97c9-76070d19f730 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewscheduledefinition Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewscheduledefinition-filterbycurrentuser.md
If successful, this function returns a `200 OK` response code and a [accessRevie
Returns all review definitions where the calling user is a reviewer. ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accessreviewscheduledefinition_filterbycurrentuser"
Returns all review definitions where the calling user is a reviewer.
``` http GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/filterByCurrentUser(on='reviewer') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewscheduledefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewscheduledefinition-get.md
If successful, this method returns a `200 OK` response code and an [accessReview
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_accessreviewscheduledefinition"
If successful, this method returns a `200 OK` response code and an [accessReview
``` http GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/3856fd6f-36e2-4152-97c9-76070d19f730 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewscheduledefinition List Instances https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewscheduledefinition-list-instances.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_accessreviewinstance"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/2dca8959-b716-4b4c-a93d-a535c01eb6e0/instances ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accessreviewscheduledefinition List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewscheduledefinition-list.md
If successful, this method returns a `200 OK` response code and a collection of
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_accessReviewScheduleDefinition"
If successful, this method returns a `200 OK` response code and a collection of
``` GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions?$top=100&$skip=0 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
Content-type: application/json
#### Request The following example shows a request to retrieve all the access review series scoped to all Microsoft 365 groups in a tenant. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_accessReviewScheduleDefinition_allgroups"
The following example shows a request to retrieve all the access review series s
```msgraph-interactive GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions?$filter=contains(scope/microsoft.graph.accessReviewQueryScope/query, './members') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Accessreviewscheduledefinition Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewscheduledefinition-post.md
This is an example of creating an access review with the following settings:
#### Request In the request body, supply a JSON representation of the [accessReviewScheduleDefinition](../resources/accessreviewscheduledefinition.md) object. - # [HTTP](#tab/http) <!-- { "blockType": "request",
Content-type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
This is an example of creating an access review with the following settings:
#### Request In the request body, supply a JSON representation of the [accessReviewScheduleDefinition](../resources/accessreviewscheduledefinition.md) object.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_accessReviewScheduleDefinition_inactiveguests_M365"
Content-type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
This is an example of creating an access review with the following settings:
+ It recurs semi-annually and ends 1 year from the startDate. #### Request+ <!-- { "blockType": "request", "name": "create_accessReviewScheduleDefinition_allusers_M365_AADRole"
v1.0 Accessreviewscheduledefinition Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewscheduledefinition-update.md
This is an example of updating the displayName of an existing access review seri
### Request In the request body, supply a JSON representation of the new properties of the [accessReviewScheduleDefinition](../resources/accessreviewscheduledefinition.md) object. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_accessreviewscheduledefinition"
PUT https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definition
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Administrativeunit Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/administrativeunit-post-members.md
POST /directory/administrativeUnits/{id}/members/$ref
| Name |Description| |:-|:-| | Authorization | Bearer {token}. Required. |
+| Content-type | application/json. Required. |
## Request body In the request body, provide the `id` of a [user](../resources/user.md), [group](../resources/group.md) or [directoryObject](../resources/directoryobject.md) to be added.
v1.0 Administrativeunit Post Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/administrativeunit-post-scopedrolemembers.md
POST /directory/administrativeUnits/{id}/scopedRoleMembers
| Name |Description| |:-|:-| | Authorization | Bearer {token}. Required.|
+| Content-type | application/json. Required. |
## Request body In the request body, supply a JSON representation of [scopedRoleMembership](../resources/scopedrolemembership.md) object.
v1.0 Administrativeunit Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/administrativeunit-update.md
PATCH /directory/administrativeUnits/{id}
| Name |Description| |:-|:-| | Authorization | Bearer {token}. Required. |
+| Content-type | application/json. Required. |
## Request body
v1.0 Channel Post Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/channel-post-messages.md
POST https://graph.microsoft.com/v1.0/teams/57fb72d0-d811-46f4-8947-305e6072eaa5
[!INCLUDE [sample-code](../includes/snippets/objc/post-channelmessage-2-objc-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Java](#tab/java)
+
POST https://graph.microsoft.com/v1.0/teams/57fb72d0-d811-46f4-8947-305e6072eaa5
[!INCLUDE [sample-code](../includes/snippets/objc/post-channelmessage-3-objc-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Java](#tab/java)
+
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chatmessage-post.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/objc/post-chatmessage-2-objc-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Java](#tab/java)
+
v1.0 Directoryrole List Scopedmembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directoryrole-list-scopedmembers.md
If successful, this method returns a `200 OK` response code and a collection of
#### Request The following is an example of a request for a directory role **id** `41d12a2f-caa8-4e3e-ba14-05e5102ce085`. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_scopedmembers_directoryrole"
The following is an example of a request for a directory role **id** `41d12a2f-c
```msgraph-interactive GET https://graph.microsoft.com/v1.0/directoryRoles/41d12a2f-caa8-4e3e-ba14-05e5102ce085/scopedMembers ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response The following example shows the response.
Content-type: application/json
#### Request The following is an example of a request for a directory role with **roleTemplateId** `fdd7a751-b60b-444a-984c-02652fe8fa1c`. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_scopedmembers_directoryrole_templateId"
The following is an example of a request for a directory role with **roleTemplat
```msgraph-interactive GET https://graph.microsoft.com/v1.0/directoryRoles/roleTemplateId=fdd7a751-b60b-444a-984c-02652fe8fa1c/scopedMembers ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response The following example shows the response.
v1.0 Group List Transitivemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-list-transitivemembers.md
Content-type: application/json
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "get_group_transitivemembers_count" }-->
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/groups/{id}/transitiveMembers/$count ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
The following is an example of the response.
HTTP/1.1 200 OK Content-type: text/plain
-```
-`893`
+893
+```
### Example 3: Use the microsoft.graph.group OData cast to get only members that are groups
Content-type: text/plain
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_group_transitivemembers_odataCast"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/groups/{id}/transitivemembers/microsoft.graph.group?$count=true ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_tier_count"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/groups/{id}/transitiveMembers/microsoft.graph.user?$count=true&$orderBy=displayName&$search="displayName:tier"&$select=displayName,id ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_a_count"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/groups/{id}/transitiveMembers/microsoft.graph.user?$count=true&$orderBy=displayName&$filter=startswith(displayName, 'a') ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Group Post Groups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-post-groups.md
Content-type: application/json
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_role_enabled_group"
Content-Type: application/json
"visibility" : "Private" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ > **Note:** The **visibility** and **groupTypes** properties are not required for creation, but are auto-populated with these values. A group with **isAssignableToRole** property set to `true` cannot be of dynamic membership type and cannot have an owner. For more information, see [Using a group to manage Azure AD role assignments](https://go.microsoft.com/fwlink/?linkid=2103037).
v1.0 User List Createdobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-list-createdobjects.md
doc_type: apiPageType
Namespace: microsoft.graph
-Get a list of directory objects that were created by the user.
+Get a list of directory objects that were created by the user. This API returns only those directory objects that were created by a user who isn't in any administrator role; otherwise, it returns an empty 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).
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /users/{id | userPrincipalName}/createdObjects
+GET /me/createdObjects
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [directoryObject](../resources/directoryobject.md) objects in the response body. ## Example ##### Request
-Here is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/v1.0/me/createdObjects
##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+The following is an example of the response. From the response, the user created a Microsoft 365 group, an application, and it's service principal.
+
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 55
{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#directoryObjects",
"value": [ {
- "id": "id-value"
+ "@odata.type": "#microsoft.graph.group",
+ "id": "92f3d47b-86cc-4b90-953e-8ec7f83ef45f",
+ "displayName": "Contoso volunteer roster",
+ "groupTypes": [
+ "Unified"
+ ],
+ "mail": "volunteers@contoso.com",
+ "mailEnabled": true,
+ "mailNickname": "volunteers"
+ },
+ {
+ "@odata.type": "#microsoft.graph.application",
+ "id": "5847962e-c746-4707-a657-f80b5b71f429",
+ "appId": "254e989a-1b8c-4f8c-84e8-9dea78e9d283",
+ "displayName": "ConVol",
+ "publisherDomain": "contoso.com",
+ "signInAudience": "AzureADMyOrg"
+ },
+ {
+ "@odata.type": "#microsoft.graph.servicePrincipal",
+ "id": "ea6a54da-62be-4cdc-9860-3ed68a43d8f6",
+ "accountEnabled": true,
+ "appDisplayName": "ConVol",
+ "appDescription": null,
+ "appId": "254e989a-1b8c-4f8c-84e8-9dea78e9d283",
+ "displayName": "ConVol",
+ "servicePrincipalNames": [
+ "254e989a-1b8c-4f8c-84e8-9dea78e9d283"
+ ],
+ "servicePrincipalType": "Application",
+ "signInAudience": "AzureADMyOrg",
} ] }
v1.0 User Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-update.md
The following example shows the response.
HTTP/1.1 204 No Content ``` +
+### Example 3: Update the passwordProfile of a user to reset their password
+
+The following example shows a request to reset the password of another user.
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "update_user_passwordProfile"
+}-->
+```http
+PATCH https://graph.microsoft.com/v1.0/users/{id}
+Content-type: application/json
+
+{
+ "passwordProfile": {
+ "forceChangePasswordNextSignIn": false,
+ "password": "xWwvJ]6NMw+bWH-d"
+ }
+}
+```
++
+#### Response
+<!-- {
+ "blockType": "response"
+} -->
+```http
+HTTP/1.1 204 No Content
+```
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- {
v1.0 Passwordprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/passwordprofile.md
Here is a JSON representation of the resource
"tocPath": "" }-->
+## See also
+
+[Update the passwordProfile of a user](../api/user-update.md#example-3-update-the-passwordprofile-of-a-user-to-reset-their-password)
v1.0 Searchrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/searchrequest.md
The JSON blob contains the types of resources expected in the response, the unde
## Properties
-| Property | Type | Description |
+| Property | Type | Description | |
|:-|:|:|:| |contentSources|String collection|Contains the connection to be targeted.| |enableTopResults|Boolean|This triggers hybrid sort for messages : the first 3 messages are the most relevant. This property is only applicable to entityType=`message`. Optional.|
-|entityTypes|entityType collection| One or more types of resources expected in the response. Possible values are: `list`, `site`, `listItem`, `message`, `event`, `drive`, `driveItem`. See [known limitations](search-api-overview.md#known-limitations) for those combinations of two or more entity types that are supported in the same search request. Required.|
+|entityTypes|entityType collection| One or more types of resources expected in the response. Possible values are: `list`, `site`, `listItem`, `message`, `event`, `drive`, `driveItem`, `externalItem`. See [known limitations](search-api-overview.md#known-limitations) for those combinations of two or more entity types that are supported in the same search request. Required.|
|fields|String collection |Contains the fields to be returned for each resource object specified in **entityTypes**, allowing customization of the fields returned by default otherwise, including additional fields such as custom managed properties from SharePoint and OneDrive. Optional.| |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.|
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
href: /graph/paging?context=graph/api/1.0 - name: Use query parameters href: /graph/query-parameters?context=graph/api/1.0
+ items:
+ - name: Use the search query parameter
+ href: /graph/search-query-parameter?context=graph/api/1.0
+ - name: Advanced query capabilities
+ href: /graph/aad-advanced-queries?context=graph/api/1.0
- name: Batching displayName: Batch requests href: /graph/json-batching?context=graph/api/1.0