Updates from: 08/18/2021 03:06:05
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackage Getapplicablepolicyrequirements https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-getapplicablepolicyrequirements.md
If successful, this method returns a `200 OK` response code and an [accessPackag
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accesspackage_getapplicablepolicyrequirements"
If successful, this method returns a `200 OK` response code and an [accessPackag
``` http POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/fb449cf8-3a59-4d86-bdfd-a1b7299681de/getApplicablePolicyRequirements ```
+# [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 Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewscheduledefinition-update.md
This is an example of updating the displayName of an existing access review seri
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"
Content-type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Authenticationmethodsroot Usersregisteredbyfeature https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationmethodsroot-usersregisteredbyfeature.md
The following permissions are required to call this API. To learn more, includin
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|AuditLogs.Read.All|
+|Delegated (work or school account)|AuditLog.Read.All|
|Delegated (personal Microsoft account)|Not supported.| |Application|Not supported.|
v1.0 Authenticationmethodsroot Usersregisteredbymethod https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationmethodsroot-usersregisteredbymethod.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|AuditLogs.Read.All|
+|Delegated (work or school account)|AuditLog.Read.All|
|Delegated (personal Microsoft account)|Not supported.| |Application|Not supported.|
v1.0 Chatmessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessage-get.md
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | |:|:--|
-|Delegated (work or school account)| ChannelMessage.Read.All, Group.Read.All, Group.Read.WriteAll |
+|Delegated (work or school account)| ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
|Delegated (personal Microsoft account)|Not supported.|
-|Application| ChannelMessage.Read.Group*, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
+|Application| ChannelMessage.Read.Group, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
### Permissions for chat
One of the following permissions is required to call this API. To learn more, in
|:|:--| |Delegated (work or school account)| Chat.Read, Chat.ReadWrite| |Delegated (personal Microsoft account)|Not supported.|
-|Application| ChatMessage.Read.Chat*, Chat.Read.All, Chat.ReadWrite.All|
+|Application| ChatMessage.Read.Chat, Chat.Read.All, Chat.ReadWrite.All|
-> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc).
+> **Note**: The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc).
> [!NOTE] > Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
v1.0 Chatmessage List Hostedcontents https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessage-list-hostedcontents.md
Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedco
| Permission type | Permissions (from least to most privileged) | |:|:--|
-|Delegated (work or school account)| ChannelMessage.Read.All, Group.Read.All, Group.Read.WriteAll |
+|Delegated (work or school account)| ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
|Delegated (personal Microsoft account)|Not supported.|
-|Application| ChannelMessage.Read.Group*, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
+|Application| ChannelMessage.Read.Group, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
### Permissions for chat
Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedco
|:|:--| |Delegated (work or school account)| Chat.Read, Chat.ReadWrite| |Delegated (personal Microsoft account)|Not supported.|
-|Application| ChatMessage.Read.Chat*, Chat.Read.All, Chat.ReadWrite.All|
+|Application| ChatMessage.Read.Chat, Chat.Read.All, Chat.ReadWrite.All|
-> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc).
+> **Note**: The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc).
> [!NOTE] > Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
v1.0 Chatmessagehostedcontent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessagehostedcontent-get.md
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | |:|:--|
-|Delegated (work or school account)| ChannelMessage.Read.All, Group.Read.All, Group.Read.WriteAll |
+|Delegated (work or school account)| ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
|Delegated (personal Microsoft account)|Not supported.|
-|Application| ChannelMessage.Read.Group*, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
+|Application| ChannelMessage.Read.Group, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
### Permissions for chat
One of the following permissions is required to call this API. To learn more, in
|:|:--| |Delegated (work or school account)| Chat.Read, Chat.ReadWrite| |Delegated (personal Microsoft account)|Not supported.|
-|Application| ChatMessage.Read.Chat*, Chat.Read.All, Chat.ReadWrite.All|
+|Application| ChatMessage.Read.Chat, Chat.Read.All, Chat.ReadWrite.All|
-> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc).
+> **Note**: The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc).
> [!NOTE] > Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
v1.0 Educationclass Post Assignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationclass-post-assignments.md
If successful, this method returns a `201 Created` response code and an [educati
##### Request The following is an example of the request.
+# [HTTP](#tab/http)
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
Content-length: 279
"allowStudentsToAddResourcesToSubmission": true } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ In the request body, supply a JSON representation of an [educationAssignment](../resources/educationassignment.md) object. ##### Response
v1.0 Group Delete Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-delete-owners.md
Title: "Remove owner"
+ Title: "Remove group owner"
description: "Use this API to remove an owner from a Microsoft 365 group, a security group, or a mail-enabled security group through the owners navigation property." localization_priority: Normal
ms.prod: "groups"
doc_type: apiPageType
-# Remove owner
+# Remove group owner
Namespace: microsoft.graph
Namespace: microsoft.graph
Use this API to remove an owner from a Microsoft 365 group, a security group, or a mail-enabled security group through the owners navigation property. When owners are assigned to a group, the last owner of the group cannot be removed.
+> **Note:** When this API is called, the user is also removed from the /groups/{id}/members list. To work around this, remove the user from both owners and members, then wait 10 seconds, then add them back to members. See [Known issues](/graph/known-issues#removing-a-group-owner-also-removes-the-user-as-a-group-member).
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Group List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list-members.md
Content-type: text/plain
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_pr_count"
The following is an example of the request.
GET https://graph.microsoft.com/beta/groups/{id}/members/microsoft.graph.user?$count=true&$orderby=displayName&$search="displayName:Pr"&$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}/members?$count=true&$filter=startswith(displayName, 'a') ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Termstore Term Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/termstore-term-update.md
The following table shows the properties that can be updated for a [term](../res
|Property|Type|Description| |:|:|:|
-|labels|[microsoft.graph.termStore.localizedLabel](../resources/termstore-localizedlabel.md) collection|labels of a term|
-|descriptions|[microsoft.graph.termStore.localizedDescription](../resources/termstore-localizeddescription.md) collection|description about the term|
-|properties|[microsoft.graph.keyValue](../resources/keyvalue.md) collection|properties associated with the term|
+|labels|[microsoft.graph.termStore.localizedLabel](../resources/termstore-localizedlabel.md) collection|Labels of a term.|
+|descriptions|[microsoft.graph.termStore.localizedDescription](../resources/termstore-localizeddescription.md) collection|Description about the term.|
+|properties|[microsoft.graph.keyValue](../resources/keyvalue.md) collection|Properties associated with the term.|
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list.md
Content-type: application/json
"displayName": "Adele Vance", "userPrincipalName": "AdeleV@contoso.com", "signInActivity": {
- "lastSignInDateTime": "2017-09-04T15:35:02Z",
- "lastSignInRequestId": "c7df2760-2c81-4ef7-b578-5b5392b571df"
+ "lastSignInDateTime": "2021-06-17T16:41:33Z",
+ "lastSignInRequestId": "d4d31c40-4c36-4775-ad59-7d1e6a171f00",
+ "lastNonInteractiveSignInDateTime": "0001-01-01T00:00:00Z",
+ "lastNonInteractiveSignInRequestId": ""
} }, { "displayName": "Alex Wilber", "userPrincipalName": "AlexW@contoso.com", "signInActivity": {
- "lastSignInDateTime": "2017-07-29T02:16:18Z",
- "lastSignInRequestId": "90d8b3f8-712e-4f7b-aa1e-62e7ae6cbe96"
+ "lastSignInDateTime": "2021-07-29T15:53:27Z",
+ "lastSignInRequestId": "f3149ee1-e347-4181-b45b-99a1f82b1c00",
+ "lastNonInteractiveSignInDateTime": "2021-07-29T17:53:42Z",
+ "lastNonInteractiveSignInRequestId": "868efa6a-b2e9-40e9-9b1c-0aaea5b50200"
} } ]
Content-type: application/json
{ "displayName": "Eric Solomon", "signInActivity": {
- "lastSignInDateTime": "2017-09-04T15:35:02Z",
- "lastSignInRequestId": "c7df2760-2c81-4ef7-b578-5b5392b571df"
+ "lastSignInDateTime": "2021-07-29T15:53:27Z",
+ "lastSignInRequestId": "f3149ee1-e347-4181-b45b-99a1f82b1c00",
+ "lastNonInteractiveSignInDateTime": "2021-07-29T17:53:42Z",
+ "lastNonInteractiveSignInRequestId": "868efa6a-b2e9-40e9-9b1c-0aaea5b50200"
} } ]
The following is an example of the request. Details for the **signInActivity** p
"name": "get_signin_last_time_range" }--> ```http
-GET https://graph.microsoft.com/beta/users?filter=signInActivity/lastSignInDateTime le 2019-06-01T00:00:00Z
+GET https://graph.microsoft.com/beta/users?filter=signInActivity/lastSignInDateTime le 2021-07-21T00:00:00Z
``` #### Response
HTTP/1.1 200 OK
Content-type: application/json {
- "@odata.context": "https://graph.microsoft.com/beta/users?filter=signInActivity/lastSignInDateTime le 2019-06-01T00:00:00Z",
+ "@odata.context": "https://graph.microsoft.com/beta/users?filter=signInActivity/lastSignInDateTime le 2021-07-21T00:00:00Z",
"value": [ { "displayName": "Adele Vance", "userPrincipalName": "AdeleV@contoso.com", "signInActivity": {
- "lastSignInDateTime": "2019-05-04T15:35:02Z",
- "lastSignInRequestId": "c7df2760-2c81-4ef7-b578-5b5392b571df"
+ "lastSignInDateTime": "2021-06-17T16:41:33Z",
+ "lastSignInRequestId": "d4d31c40-4c36-4775-ad59-7d1e6a171f00",
+ "lastNonInteractiveSignInDateTime": "0001-01-01T00:00:00Z",
+ "lastNonInteractiveSignInRequestId": ""
} }, { "displayName": "Alex Wilber", "userPrincipalName": "AlexW@contoso.com", "signInActivity": {
- "lastSignInDateTime": "2019-04-29T02:16:18Z",
- "lastSignInRequestId": "90d8b3f8-712e-4f7b-aa1e-62e7ae6cbe96"
+ "lastSignInDateTime": "2021-07-29T15:53:27Z",
+ "lastSignInRequestId": "f3149ee1-e347-4181-b45b-99a1f82b1c00",
+ "lastNonInteractiveSignInDateTime": "2021-07-29T17:53:42Z",
+ "lastNonInteractiveSignInRequestId": "868efa6a-b2e9-40e9-9b1c-0aaea5b50200"
} } ]
v1.0 Authenticationmethods Usage Insights Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/authenticationmethods-usage-insights-overview.md
The following permissions are required to call this API. To learn more, includin
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Reports.Read.All<br>AuditLogs.Read.All|
+|Delegated (work or school account)|Reports.Read.All, AuditLog.Read.All|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|Reports.Read.All<br>AuditLogs.Read.All|
+|Application|Reports.Read.All, AuditLog.Read.All|
In order to access the API, [one of the following roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles) is required:
v1.0 Signinactivity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/signinactivity.md
Title: "signInActivity resource type"
-description: "Provides the last signed-in date for a specific user."
+description: "Provides the last interactive or non-interactive sign-in time for a specific user."
localization_priority: Normal ms.prod: "identity-and-access-reports"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Provides the last signed-in date for a specific [user](user.md).
+Provides the last interactive or non-interactive sign-in time for a specific [user](user.md).
## Properties | Property | Type | Description | |:-|:|:| |lastSignInDateTime|DateTimeOffset|The last interactive sign-in date for a specific user. You can use this field to calculate the last time a user signed in to the directory with an interactive authentication method. This field can be used to build reports, such as inactive users. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is: `'2014-01-01T00:00:00Z'`. For more information about using the value of this property, see [Manage inactive user accounts in Azure AD](/azure/active-directory/reports-monitoring/howto-manage-inactive-user-accounts).|
-|lastSignInRequestId|String|Request ID of the last sign-in performed by this user.|
+|lastSignInRequestId|String|Request identifier of the last interactive sign-in performed by this user.|
+|lastNonInteractiveSignInDateTime|DateTimeOffset|The last non-interactive sign-in date for a specific user. You can use this field to calculate the last time a client signed in to the directory on behalf of a user. Because some users may use clients to access tenant resources rather than signing into your tenant directly, you can use the non-interactive sign-in date to along with lastSignInDateTime to identify inactive users. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is: `'2014-01-01T00:00:00Z'`. For more information about using the value of this property, see [Manage inactive user accounts in Azure AD](/azure/active-directory/reports-monitoring/howto-manage-inactive-user-accounts).|
+|lastNonInteractiveSignInRequestId|String|Request identifier of the last non-interactive sign-in performed by this user.|
## JSON representation
The following is a JSON representation of the resource.
```json { "lastSignInDateTime": "String (timestamp)",
- "lastSignInRequestId": "String"
+ "lastSignInRequestId": "String",
+ "lastNonInteractiveSignInDateTime": "String (timestamp)",
+ "lastNonInteractiveSignInRequestId": "String"
} ```
v1.0 Teams Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/teams-api-overview.md
The following are the differences at the API level between teams and groups:
## Membership changes in Microsoft Teams
-To add members and owners to a team, change the membership of the [group](../resources/group.md) with the same ID.
- | Use case | Verb | URL | | - | | |
-| [Add member](../api/group-post-members.md) | POST | /groups/{id}/members/$ref |
-| [Remove member](../api/group-delete-members.md) | DELETE | /groups/{id}/members/{userId}/$ref |
-| [Add owner](../api/group-post-owners.md) | POST | /groups/{id}/owners/$ref |
-| [Remove owner](../api/group-delete-owners.md) | DELETE | /groups/{id}/owners/{userId}/$ref |
+| [Add member](../api/team-post-members.md) | POST | /teams/{id}/members |
+| [Remove member](../api/team-delete-members.md) | DELETE | /teams/{id}/members/{userId} |
+| [Update member's role](../api/team-update-members.md) | PATCH | /teams/{id}/members/{userId} |
| [Update team](../api/team-update.md) | PATCH | /teams/{id} |
-We recommend that when you add an owner, you also add that user as a member.
-If a team has an owner who is not also a member, ownership and membership changes might not show up immediately in Microsoft Teams.
-In addition, different apps and APIs will handle that differently.
-For example, Microsoft Teams will show teams that the user is either a member or an owner of, while the Microsoft Teams PowerShell cmdlets and the /me/joinedTeams API will only show teams the user is a member of.
-To avoid confusion, add all owners to the members list as well.
-
-Known issue: when DELETE /groups/{id}/owners is called, the user is also removed from the /groups/{id}/members list. To work around this, we recommend that you remove the user from both owners and members, then wait 10 seconds, then add them back to members.
- When adding and removing members and owners, don't put braces { } around the ID. | Speed | Syntax |
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
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"
Content-type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 Chatmessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chatmessage-get.md
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | |:|:--|
-|Delegated (work or school account)| ChannelMessage.Read.All, Group.Read.All, Group.Read.WriteAll |
+|Delegated (work or school account)| ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
|Delegated (personal Microsoft account)|Not supported.|
-|Application| ChannelMessage.Read.Group*, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
+|Application| ChannelMessage.Read.Group, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
### Permissions for chat
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application| Chat.Read.All, Chat.ReadWrite.All|
-> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc).
+> **Note**: The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc).
> [!NOTE] > Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
v1.0 Contact Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contact-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } -->
-A [contact](../resources/contact.md) from a user's default [contactFolder](../resources/contactfolder.md).
+A [contact](../resources/contact.md) in the user's mailbox.
```http GET /me/contacts/{id} GET /users/{id | userPrincipalName}/contacts/{id}
v1.0 Group Delete Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-delete-owners.md
Title: "Remove owner"
+ Title: "Remove group owner"
description: "Use this API to remove an owner from a Microsoft 365 group, a security group, or a mail-enabled security group through the owners navigation property." localization_priority: Normal
ms.prod: "groups"
doc_type: apiPageType
-# Remove owner
+# Remove group owner
Namespace: microsoft.graph Use this API to remove an owner from a Microsoft 365 group, a security group, or a mail-enabled security group through the owners navigation property. Once owners are assigned to a group, the last owner of the group cannot be removed.
+> **Note:** When this API is called, the user is also removed from the /groups/{id}/members list. To work around this, remove the user from both owners and members, then wait 10 seconds, then add them back to members. See [Known issues](/graph/known-issues#removing-a-group-owner-also-removes-the-user-as-a-group-member).
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Group List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-list-members.md
Content-type: text/plain
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_pr_count"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/groups/{id}/members/microsoft.graph.user?$count=true&$orderby=displayName&$search="displayName:Pr"&$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}/members?$count=true&$filter=startswith(displayName, 'a') ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Teams Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/teams-api-overview.md
The following are the differences at the API level between teams and groups:
## Membership changes in Microsoft Teams
-To add members and owners to a team, change the membership of the [group](../resources/group.md) with the same ID.
- | Use case | Verb | URL | | - | | |
-| [Add member](../api/group-post-members.md) | POST | /groups/{id}/members/$ref |
-| [Remove member](../api/group-delete-members.md) | DELETE | /groups/{id}/members/{userId}/$ref |
-| [Add owner](../api/group-post-owners.md) | POST | /groups/{id}/owners/$ref |
-| [Remove owner](../api/group-delete-owners.md) | DELETE | /groups/{id}/owners/{userId}/$ref |
+| [Add member](../api/team-post-members.md) | POST | /teams/{id}/members |
+| [Remove member](../api/team-delete-members.md) | DELETE | /teams/{id}/members/{userId} |
+| [Update member's role](../api/team-update-members.md) | PATCH | /teams/{id}/members/{userId} |
| [Update team](../api/team-update.md) | PATCH | /teams/{id} |
-We recommend that when you add an owner, you also add that user as a member.
-If a team has an owner who is not also a member, ownership and membership changes might not show up immediately in Microsoft Teams.
-In addition, different apps and APIs will handle that differently.
-For example, Microsoft Teams will show teams that the user is either a member or an owner of, while the Microsoft Teams PowerShell cmdlets and the /me/joinedTeams API will only show teams the user is a member of.
-To avoid confusion, add all owners to the members list as well.
-
-Known issue: when DELETE /groups/{id}/owners is called, the user is also removed from the /groups/{id}/members list. To work around this, we recommend that you remove the user from both owners and members, then wait 10 seconds, then add them back to members.
- When adding and removing members and owners, don't put braces { } around the ID. | Speed | Syntax |