Updates from: 07/23/2022 01:16:41
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Channel Doesuserhaveaccess https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-doesuserhaveaccess.md
The following is an example of a request.
} --> ``` http
-GET https://graph.microsoft.com/beta/teams/{0fddfdc5-f319-491f-a514-be1bc1bf9ddc}/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='6285581f-484b-4845-9e01-60667f8b12ae')
+GET https://graph.microsoft.com/beta/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='6285581f-484b-4845-9e01-60667f8b12ae')
``` # [C#](#tab/csharp)
The following is an example of a request.
} --> ``` http
-GET https://graph.microsoft.com/beta/teams/{0fddfdc5-f319-491f-a514-be1bc1bf9ddc}/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='62855810-484b-4823-9e01-60667f8b12ae', tenantId='57fb72d0-d811-46f4-8947-305e6072eaa5')
+GET https://graph.microsoft.com/beta/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='62855810-484b-4823-9e01-60667f8b12ae', tenantId='57fb72d0-d811-46f4-8947-305e6072eaa5')
``` # [C#](#tab/csharp)
The following is an example of a request.
} --> ``` http
-GET https://graph.microsoft.com/beta/teams/{0fddfdc5-f319-491f-a514-be1bc1bf9ddc}/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userPrincipalName='john.doe@contoso.com')
+GET https://graph.microsoft.com/beta/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userPrincipalName='john.doe@contoso.com')
``` # [C#](#tab/csharp)
v1.0 Channel Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-post.md
Namespace: microsoft.graph
Create a new [channel](../resources/channel.md) in a team, as specified in the request body. > **Note:** You can add a maximum of 200 members when you create a private channel.
-> [!IMPORTANT]
-> Shared channels are currently in public preview status. During this time, the Microsoft Graph API to create a shared channel is available to a limited audience. We recommend creating shared channels in the Teams client and using Microsoft Graph APIs to manage them. For details about how to enable shared channels in the Teams client, see [Shared channels in Microsoft Teams (Preview)](/microsoftteams/shared-channels).
-- ## 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 Reportroot Getbrowserdistributionusercounts https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/reportroot-getbrowserdistributionusercounts.md
Title: "reportRoot: getBrowserDistributionUserCounts"
-description: "Get a report that provides the total number of users using Microsoft Edge, Microsoft Edge Legacy, and Internet Explorer when used to access the Microsoft 365 services over a selected period."
+description: "Get a report that provides the total number of users using Microsoft Edge when used to access the Microsoft 365 services over a selected period."
ms.localizationpriority: medium ms.prod: "reports"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a report that provides the total number of users using Microsoft Edge, Microsoft Edge Legacy, and Internet Explorer when used to access the Microsoft 365 services over a selected period.
+Get a report that provides the total number of users using Microsoft Edge when used to access the Microsoft 365 services over a selected period.
> **Note:** For details about different report views and names, see [Microsoft 365 Reports in the admin center - Microsoft browser usage](/microsoft-365/admin/activity-reports/browser-usage-report).
The CSV file has the following headers for columns:
- Report Refresh Date - Report Period - Edge-- Edge Legacy-- Internet Explorer ### JSON
Follow the 302 redirection and the CSV file that downloads will have the followi
HTTP/1.1 200 OK Content-Type: application/octet-stream
-Report Refresh Date, Report Period, Edge, Edge Legacy, Internet Explorer
+Report Refresh Date, Report Period, Edge
``` ### Example 2: JSON output
Content-Length: 294
"userCounts":[ { "reportPeriod":7,
- "edge":1269,
- "edgeLegacy":114,
- "ie":393
+ "edge":1269
}, { "reportPeriod":30,
- "edge":1405,
- "edgeLegacy":383,
- "ie":708
+ "edge":1405
}, { "reportPeriod":90,
- "edge":1482,
- "edgeLegacy":687,
- "ie":988
+ "edge":1482
}, { "reportPeriod":180,
- "edge":1526,
- "edgeLegacy":860,
- "ie":1137
- }
+ "edge":1526
] } ]
v1.0 Reportroot Getbrowserusercounts https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/reportroot-getbrowserusercounts.md
Title: "reportRoot: getBrowserUserCounts"
-description: "Get a report that provides the trend in usage for the number of active users using Microsoft Edge, Microsoft Edge Legacy, and Internet Explorer when used to access the Microsoft 365 services over a selected period."
+description: "Get a report that provides the trend in usage for the number of active users using Microsoft Edge when used to access the Microsoft 365 services over a selected period."
ms.localizationpriority: medium ms.prod: "reports"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a report that provides the trend in usage for the number of active users using Microsoft Edge, Microsoft Edge Legacy, and Internet Explorer when used to access the Microsoft 365 services over a selected period.
+Get a report that provides the trend in usage for the number of active users using Microsoft Edge when used to access the Microsoft 365 services over a selected period.
> **Note:** For details about different report views and names, see [Microsoft 365 Reports in the admin center - Microsoft browser usage](/microsoft-365/admin/activity-reports/browser-usage-report).
The CSV file has the following headers for columns:
- Report Period - Report Date - Edge-- Edge Legacy-- Internet Explorer ### JSON
Follow the 302 redirection and the CSV file that downloads will have the followi
HTTP/1.1 200 OK Content-Type: application/octet-stream
-Report Refresh Date, Report Period, Report Date, Edge, Edge Legacy, Internet Explorer
+Report Refresh Date, Report Period, Report Date, Edge
``` ### Example 2: JSON output
Content-Length: 205
"userCounts":[ { "reportDate":"2021-04-17",
- "edge":413,
- "edgeLegacy":11,
- "ie":21
+ "edge":413
}, { "reportDate":"2021-04-16",
- "edge":883,
- "edgeLegacy":26,
- "ie":124
+ "edge":883
} ] }
v1.0 Reportroot Getbrowseruserdetail https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/reportroot-getbrowseruserdetail.md
Title: "reportRoot: getBrowserUserDetail"
-description: "Get a report that provides the browsers (Microsoft Edge, Microsoft Edge Legacy, and Internet Explorer) used by users when they access the Microsoft 365 services over a selected period."
+description: "Get a report that provides the browser (Microsoft Edge) used by users when they access the Microsoft 365 services over a selected period."
ms.localizationpriority: medium ms.prod: "reports"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a report that provides the browsers (Microsoft Edge, Microsoft Edge Legacy, and Internet Explorer) used by users when they access the Microsoft 365 services over a selected period.
+Get a report that provides the browser (Microsoft Edge) used by users when they access the Microsoft 365 services over a selected period.
> **Note:** For details about different report views and names, see [Microsoft 365 Reports in the admin center - Microsoft browser usage](/microsoft-365/admin/activity-reports/browser-usage-report).
The CSV file has the following headers for columns:
- User Principal Name - Report Period - Edge-- Edge Legacy-- Internet Explorer ### JSON
Follow the 302 redirection and the CSV file that downloads will have the followi
HTTP/1.1 200 OK Content-Type: application/octet-stream
-Report Refresh Date, User Principal Name, Report Period, Edge, Edge Legacy, Internet Explorer
+Report Refresh Date, User Principal Name, Report Period, Edge
``` ### Example 2: JSON output
Content-Length: 304
"details":[ { "reportPeriod":7,
- "edge":true,
- "edgeLegacy":true,
- "ie":false
+ "edge":true
} ] }
v1.0 Sharedwithchannelteaminfo Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/sharedwithchannelteaminfo-get.md
Title: "Get sharedWithChannelTeamInfo"
-description: "Get a team shared with a channel."
+description: "Get a team that has been shared with a specified channel."
doc_type: "apiPageType" ms.localizationpriority: high
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a [team](../resources/sharedwithchannelteaminfo.md) which has been shared a specified [channel](../resources/channel.md). This operation is allowed only for channels with a **membershipType** value of `shared`.
+Get a [team](../resources/sharedwithchannelteaminfo.md) that has been shared with a specified [channel](../resources/channel.md). This operation is allowed only for channels with a **membershipType** value of `shared`.
## 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 User List Joinedteams https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list-joinedteams.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Get the [teams](../resources/team.md) in Microsoft Teams that the user is a direct member of.
-> **Note**: This API doesn't return the host team of the shared channel that the user is a direct member of.
+> **Note:** This API doesn't return the host team of the shared channel that the user is a direct member of. Use the [List associated teams](../api/associatedteaminfo-list.md) API, to retrieve the host teams of the shared channels that the user has access to.
## 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
|Delegated (personal Microsoft account) | Not supported. | |Application | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All**, Directory.ReadWrite.All** |
-> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
+> **Note:** Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
> **Note:** Currently, with user delegated permissions, this operation only works for the `me` user. With application permissions, it works for all users by specifying the specific user ID (`me` alias is not supported with application permissions). For details, see [Known issues](/graph/known-issues#microsoft-teams-users-list-of-joined-teams-preview).
v1.0 Associatedteaminfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/associatedteaminfo.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a [team](team.md) that is associated with a [user](../resources/user.md).
+Represents a [team](team.md) that is associated with a [user](../resources/user.md).
+ Currently, a [user](../resources/user.md) can be associated with a [team](../resources/team.md) in two different ways: * A [user](../resources/user.md) can be a direct member of a [team](../resources/team.md). * A [user](../resources/user.md) can be a member of a shared [channel](../resources/channel.md) that is hosted inside a [team](../resources/team.md).
Inherits from [teamInfo](../resources/teaminfo.md).
## Properties |Property|Type|Description| |:|:|:|
-|displayName|String|The name of the team. Inherited from [teamInfo](../resources/teaminfo.md).|
+|displayName|String|The name of the [team](team.md). Inherited from [teamInfo](../resources/teaminfo.md).|
+|id|String|The unique identifier for the [team](team.md). Read-only.|
|tenantId|String|The ID of the Azure Active Directory tenant. Inherited from [teamInfo](../resources/teaminfo.md).|
v1.0 Channel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/channel.md
where files are shared, and where tabs are added.
|[Remove tab from channel](../api/channel-delete-tabs.md) | None | Remove (unpin) a tab from a channel.| |[Provision channel email address](../api/channel-provisionemail.md) |[provisionChannelEmailResult](../resources/provisionchannelemailresult.md)| Provision an email address for the channel.| |[Remove channel email address](../api/channel-removeemail.md) | None | Remove the email address of the channel.|
-|[Remove incoming channel](../api/team-delete-incomingchannels.md) | None| Remove an incoming channel.|
+|[Remove incoming channel](../api/team-delete-incomingchannels.md) | None| Remove an incoming [channel](../resources/channel.md) (a **channel** shared with a **team**) from a [team](../resources/team.md).|
|[List teams sharing a channel](../api/sharedwithchannelteaminfo-list.md)|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) collection|Get the list of teams that has been shared the specified channel.| |[Get team sharing a channel](../api/sharedwithchannelteaminfo-get.md)|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md)|Get a team that has been shared the specified channel.| |[Unshare channel with team](../api/sharedwithchannelteaminfo-delete.md)|None|Unshare a channel with a team.|
v1.0 Microsoft 365 Browser Usage Report https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/microsoft-365-browser-usage-report.md
Title: "Microsoft 365 browser usage reports"
-description: "Use the Microsoft 365 browser usage reports to get insights into the usage of browsers (Microsoft Edge, Microsoft Edge Legacy, and Internet Explorer) in your organization."
+description: "Use the Microsoft 365 browser usage reports to get insights into the usage of browser (Microsoft Edge) in your organization."
ms.localizationpriority: medium ms.prod: "reports"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Use the Microsoft 365 browser usage reports to get insights into the usage of browsers (Microsoft Edge, Microsoft Edge Legacy, and Internet Explorer) in your organization.
+Use the Microsoft 365 browser usage reports to get insights into the usage of browser (Microsoft Edge) in your organization.
> **Note:** For details about different report views and names, see [Microsoft 365 Reports in the admin center - Microsoft browser usage](/microsoft-365/admin/activity-reports/browser-usage-report).
v1.0 Report https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/report.md
The following table shows the availability for each API across all cloud deploym
| | | - | - | | | [Microsoft 365 activations](/graph/api/resources/office-365-activations-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | | [Microsoft 365 active users](/graph/api/resources/office-365-active-users-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Microsoft 365 apps usage](/graph/api/resources/microsoft-365-apps-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
+| [Microsoft 365 apps usage](/graph/api/resources/microsoft-365-apps-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
| [Microsoft 365 browser usage](/graph/api/resources/microsoft-365-browser-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | | [Microsoft 365 groups activity](/graph/api/resources/office-365-groups-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | | [Microsoft Teams device usage](/graph/api/resources/microsoft-teams-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ₧û | Γ₧û |
v1.0 Sharedwithchannelteaminfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/sharedwithchannelteaminfo.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a information for a [team](team.md) with which a channel is shared. A [team](team.md) can be shared multiple channels.
+Represents information for a [team](team.md) with which a channel is shared. A [team](team.md) can be shared multiple channels.
Inherits from [teamInfo](../resources/teaminfo.md).
Inherits from [teamInfo](../resources/teaminfo.md).
## Properties |Property|Type|Description| |:|:|:|
-|displayName|String|The name of the team. Inherited from [teamInfo](../resources/teaminfo.md).|
+|displayName|String|The name of the [team](team.md). Inherited from [teamInfo](../resources/teaminfo.md).|
+|id|String|The unique identifier for the [team](team.md). Read-only.|
|isHostTeam|Boolean|Indicates whether the [team](team.md) is the host of the [channel](channel.md).| |tenantId|String|The ID of the Azure Active Directory tenant. Inherited from [teamInfo](../resources/teaminfo.md).|
v1.0 Team https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/team.md
Every team is associated with a [Microsoft 365 group](../resources/group.md). Th
|[List all channels](../api/team-list-allchannels.md)|[channel](../resources/channel.md) collection|Get the list of [channels](../resources/channel.md) either in this **team** or shared with this **team** (incoming channels).| |[List channels](../api/channel-list.md)|[channel](../resources/channel.md) collection|Get the list of [channels](../resources/channel.md) in a **team**.| |[List incoming channels](../api/team-list-incomingchannels.md)|[channel](../resources/channel.md) collection|Get the list of [channels](../resources/channel.md) shared with this **team**.|
-|[Remove incoming channel](../api/team-delete-incomingchannels.md) | None| Remove an incoming channel.|
+|[Remove incoming channel](../api/team-delete-incomingchannels.md) | None| Remove an incoming [channel](../resources/channel.md) (a **channel** shared with a **team**) from a [team](../resources/team.md).|
|[List apps installed in team](../api/team-list-installedapps.md) | [teamsAppInstallation](teamsappinstallation.md) collection | List apps installed in a team.| |[Add app to team](../api/team-post-installedapps.md) |None | Add (install) an app to a team.| |[Get app installed in team](../api/team-get-installedapps.md) | [teamsAppInstallation](teamsappinstallation.md) | Get the specified app installed in a team.|
v1.0 Teaminfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/teaminfo.md
Base type of [associatedTeamInfo](associatedteaminfo.md) and [sharedWithChannelT
## Properties |Property|Type|Description| |:|:|:|
-|displayName|String|The name of the team.|
+|displayName|String|The name of the [team](team.md).|
+|id|String|The unique identifier for the [team](team.md). Read-only.|
|tenantId|String|The ID of the Azure Active Directory tenant.|
v1.0 Associatedteaminfo List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/associatedteaminfo-list.md
+
+ Title: "List associatedTeamInfo"
+description: "Get the list of teams in Microsoft Teams that a user is associated with."
+
+ms.localizationpriority: high
++
+# List associatedTeamInfo
+Namespace: microsoft.graph
+
+Get the list of [teams](../resources/associatedteaminfo.md) in Microsoft Teams that a [user](../resources/user.md) is associated with.
+Currently, a [user](../resources/user.md) can be associated with a [team](../resources/team.md) in two different ways:
+* A [user](../resources/user.md) can be a direct member of a [team](../resources/team.md).
+* A [user](../resources/user.md) can be a member of a shared [channel](../resources/channel.md) that is hosted inside a [team](../resources/team.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All|
+
+> **Note:** Currently, with user delegated permissions, this operation only works for the `me` user. With application permissions, it works for all users by specifying the specific user ID (`me` alias is not supported with application permissions).
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /users/{user-id}/teamwork/associatedTeams
+```
+
+## Optional query parameters
+This method does not currently support the [OData query parameters](/graph/query-parameters) to customize the response.
+
+## 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 [associatedTeamInfo](../resources/associatedteaminfo.md) objects in the response body.
+
+> **Note**: This API also returns the host team of the shared channel that the user is a direct member of.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "list_associatedteaminfo"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/me/teamwork/associatedTeams
+```
+
+### Response
+
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.associatedTeamInfo",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.associatedTeamInfo",
+ "id": "b695c5a5-c5a5-b695-a5c5-95b6a5c595b6",
+ "tenantId": "172b0cce-e65d-7hd4-9a49-91d9f2e8493a",
+ "displayName": "Contoso Team"
+ },
+ {
+ "@odata.type": "#microsoft.graph.associatedTeamInfo",
+ "id": "b695c5a5-8934-b695-a5c5-95b6a5c595b6",
+ "tenantId": "172b0cce-8961-7hd4-9a49-91d9f2e8493a",
+ "displayName": "Fabrikam Team"
+ }
+ ]
+}
+```
++
+## See also
+
+- [List joinedTeams](../api/user-list-joinedteams.md)
+- [Get team](../api/team-get.md)
+
v1.0 Authentication Post Temporaryaccesspassmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/authentication-post-temporaryaccesspassmethods.md
If successful, this method returns a `201 Created` response code and a [temporar
"name": "create_temporaryaccesspassauthenticationmethod_from_" } -->
-```msgraph-interactive
+```http
POST https://graph.microsoft.com/v1.0/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods Content-Type: application/json
v1.0 Channel Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-delete-members.md
ms.prod: "microsoft-teams"
Namespace: microsoft.graph
-Delete a [conversationMember](../resources/conversationmember.md) from a [channel](../resources/channel.md). This operation is allowed only for channels with a **membershipType** value of `private`.
+Delete a [conversationMember](../resources/conversationmember.md) from a [channel](../resources/channel.md). This operation is allowed only for channels with a **membershipType** value of `private` or `shared`.
## Permissions
v1.0 Channel Doesuserhaveaccess https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-doesuserhaveaccess.md
+
+ Title: "channel: doesUserHaveAccess"
+description: "Determine whether a user has access to a shared channel."
+
+ms.localizationpriority: medium
++
+# channel: doesUserHaveAccess
+Namespace: microsoft.graph
+
+Determine whether a [user](../resources/useridentity.md) has access to a shared [channel](../resources/channel.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) | ChannelMember.Read.All, ChannelMember.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | ChannelMember.Read.All, ChannelMember.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /teams/{team-id}/channels/{channel-id}/doesUserHaveAccess
+```
+
+## Function parameters
+In the request URL, provide the following query parameters with values.
+The following table shows the parameters that can be used with this function.
+
+|Parameter|Type|Description|
+|:|:|:|
+|tenantId|String|The ID of the Azure Active Directory tenant that the [user](../resources/useridentity.md) belongs to. The default value for this property is the current **tenantId** of the signed-in user or app.|
+|userId|String|Unique identifier for the [user](../resources/useridentity.md). Either specify the **userId** or the **userPrincipalName** property in the request.|
+|userPrincipalName|String|The user principal name (UPN) of the [user](../resources/useridentity.md). Either specify the **userId** or the **userPrincipalName** property in the request.|
++
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this function.
+
+## Response
+
+If successful, this function returns a `200 OK` response code and a Boolean in the response body.
+
+## Examples
+
+### Example 1: Check access for an internal user
+
+The following is an example of a request that checks whether an internal user has access to a shared channel.
+
+#### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "channel_doesuserhaveaccess"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='6285581f-484b-4845-9e01-60667f8b12ae')
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "@odata.type": "string"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": true
+}
+```
++
+### Example 2: Check access for an external user
+
+The following is an example of a request that uses the **tenantId** property to check whether an external user has access to a shared channel.
+
+#### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "channel_doesuserhaveaccess_externaluser"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='62855810-484b-4823-9e01-60667f8b12ae', tenantId='57fb72d0-d811-46f4-8947-305e6072eaa5')
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "@odata.type": "string"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": true
+}
+```
++
+### Example 3: Check user access for a user using the user principal name
+
+The following is an example of a request that uses the **userPrincipalName** property to check whether an internal user has access to a shared channel.
+
+#### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "channel_doesuserhaveaccess_usingupn"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userPrincipalName='john.doe@contoso.com')
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "@odata.type": "string"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": false
+}
+```
+
v1.0 Channel List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-list.md
Content-type: application/json
} ```
+### Example 3: List all shared channels
+
+#### Request
+
+The following example shows a request to list all shared channels.
++
+<!-- {
+ "blockType": "request",
+ "name": "list_shared_channels"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/teams/6a720ba5-7373-463b-bc9f-4cd04b5c6742/channels?$filter=membershipType eq 'shared'
+```
+
+#### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.channel",
+ "isCollection": true
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+Content-length: 262
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('6a720ba5-7373-463b-bc9f-4cd04b5c6742')/channels",
+ "@odata.count": 1,
+ "value": [
+ {
+ "id": "19:LpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81@thread.tacv2",
+ "createdDateTime": null,
+ "displayName": "shared channel-01",
+ "description": "this is the shared channel description",
+ "isFavoriteByDefault": null,
+ "email": "",
+ "webUrl": "https://teams.microsoft.com/l/channel/19%3ALpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81%40thread.tacv2/shared%20channel-01?groupId=6a720ba5-7373-463b-bc9f-4cd04b5c6742&tenantId=df81db53-c7e2-418a-8803-0e68d4b88607",
+ "membershipType": "shared",
+ "moderationSettings": null
+ }
+ ]
+}
+```
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Channel Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-post-members.md
ms.prod: "microsoft-teams"
Namespace: microsoft.graph
-Add a [conversationMember](../resources/conversationmember.md) to a [channel](../resources/channel.md). This operation is allowed only for channels with a **membershipType** value of `private`.
+Add a [conversationMember](../resources/conversationmember.md) to a [channel](../resources/channel.md). This operation is allowed only for channels with a **membershipType** value of `private` or `shared`.
## Permissions
If successful, this method returns a `201 Created` response code and a [conversa
## Examples
-### Example 1: Add a member to a channel
+### Example 1: Add a member to a private channel
#### Request-
+The following is an example of a request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
Content-type: application/json
#### Response-
+The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response",
Content-type: application/json
} ```
-### Example 2: Add a member with the owner role to a channel
+### Example 2: Add a member with the owner role to a private channel
#### Request
+The following is an example of a request.
-
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "channel_add_member_2"
Content-type: application/json
POST https://graph.microsoft.com/v1.0/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d82/channels/19%3A56eb04e133944cf69e603c5dac2d292e%40thread.skype/members ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PowerShell](#tab/powershell)
-
-# [PHP](#tab/php)
---- #### Response
-Here is an example of the response.
+The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability. <!-- {
Content-type: application/json
### Example 3: Add an owner to a channel using user principal name #### Request
+The following is an example of a request.
-
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "channel_add_member_3"
Content-type: application/json
} ```
-# [C#](#tab/csharp)
-# [JavaScript](#tab/javascript)
+#### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.conversationMember"
+} -->
-# [Java](#tab/java)
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
-# [Go](#tab/go)
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('ece6f0a1-7ca4-498b-be79-edf6c8fc4d82')/channels('19%3A56eb04e133944cf69e603c5dac2d292e%40thread.skype')/members/microsoft.graph.aadUserConversationMember/$entity",
+ "@odata.type": "#microsoft.graph.aadUserConversationMember",
+ "id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
+ "roles": [],
+ "displayName": "Jacob Hancock",
+ "userId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "email": "jacob@contoso.com"
+}
+```
+### Example 4: Add a user who is part of the same tenant as a member to a shared channel
-# [PowerShell](#tab/powershell)
+#### Request
-# [PHP](#tab/php)
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "shared_channel_add_intra_tenant_member"
+} -->
-
+```http
+POST https://graph.microsoft.com/v1.0/teams/6a720ba5-7373-463b-bc9f-4cd04b5c6742/channels/19:LpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81@thread.tacv2/members
+Content-type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.aadUserConversationMember",
+ "roles": [],
+ "user@odata.bind": "https://graph.microsoft.com/v1.0/users/24b3819b-4e1d-4f3e-86bd-e42b54d0b2b4"
+}
+```
+
+#### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.conversationMember"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+Content-length: 468
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('6a720ba5-7373-463b-bc9f-4cd04b5c6742')/channels('19%3ALpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81%40thread.tacv2')/members/$entity",
+ "@odata.type": "#microsoft.graph.aadUserConversationMember",
+ "id": "ZGY4MWRiNTMtYzdlMi00MThhLTg4MDMtMGU2OGQ0Yjg4NjA3IyMxOTpMcHhTaEhaWmg5dXRqTmNFbVVTNWFPRVA5QVN3ODVPVW4wNU5jV1lBaFg4MUB0aHJlYWQudGFjdjIjIzI0YjM4MTliLTRlMWQtNGYzZS04NmJkLWU0MmI1NGQwYjJiNA==",
+ "roles": [],
+ "displayName": "John Doe",
+ "visibleHistoryStartDateTime": null,
+ "userId": "24b3819b-4e1d-4f3e-86bd-e42b54d0b2b4",
+ "email": "john_doe@contoso.com",
+ "tenantId": "df81db53-c7e2-418a-8803-0e68d4b88607"
+}
+```
+
+### Example 5: Add a user who is part of a different tenant as a member to a shared channel
+
+#### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "shared_channel_add_x_tenant_member"
+} -->
+
+```http
+POST https://graph.microsoft.com/v1.0/teams/6a720ba5-7373-463b-bc9f-4cd04b5c6742/channels/19:LpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81@thread.tacv2/members
+Content-type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.aadUserConversationMember",
+ "roles": [],
+ "user@odata.bind": "https://graph.microsoft.com/v1.0/users/bc3598dd-cce4-4742-ae15-173429951408",
+ "tenantId": "a18103d1-a6ef-4f66-ac64-e4ef42ea8681"
+}
+```
#### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.conversationMember"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+Content-length: 468
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('6a720ba5-7373-463b-bc9f-4cd04b5c6742')/channels('19%3ALpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81%40thread.tacv2')/members/$entity",
+ "@odata.type": "#microsoft.graph.aadUserConversationMember",
+ "id": "YTE4MTAzZDEtYTZlZi00ZjY2LWFjNjQtZTRlZjQyZWE4NjgxIyMxOTpMcHhTaEhaWmg5dXRqTmNFbVVTNWFPRVA5QVN3ODVPVW4wNU5jV1lBaFg4MUB0aHJlYWQudGFjdjIjI2JjMzU5OGRkLWNjZTQtNDc0Mi1hZTE1LTE3MzQyOTk1MTQwOA==",
+ "roles": [],
+ "displayName": "Eric Solomon",
+ "visibleHistoryStartDateTime": null,
+ "userId": "bc3598dd-cce4-4742-ae15-173429951408",
+ "email": "ericsol@fabrikam.com",
+ "tenantId": "a18103d1-a6ef-4f66-ac64-e4ef42ea8681"
+}
+```
+
+### Example 6: Add a user who is part of the same or a different tenant as a member to a shared channel using user principal name
+
+#### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "channel_add_member_6"
+} -->
+```http
+POST https://graph.microsoft.com/beta/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d82/channels/19%3ALpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81%40thread.tacv2/members
+Content-type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.aadUserConversationMember",
+ "roles": [],
+ "user@odata.bind": "https://graph.microsoft.com/beta/users('jacob@contoso.com')"
+}
+```
+
+#### Response
+
+The following is an example of the response.
+ >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response",
HTTP/1.1 201 Created
Content-type: application/json {
- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('ece6f0a1-7ca4-498b-be79-edf6c8fc4d82')/channels('19%3A56eb04e133944cf69e603c5dac2d292e%40thread.skype')/members/microsoft.graph.aadUserConversationMember/$entity",
- "@odata.type": "#microsoft.graph.aadUserConversationMember",
- "id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
- "roles": [],
- "displayName": "Jacob Hancock",
- "userId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
- "email": "jacob@contoso.com"
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('ece6f0a1-7ca4-498b-be79-edf6c8fc4d82')/channels('19%3ALpxShHZZh9utjNcEmUS5aOEP9ASw85OUn05NcWYAhX81%40thread.tacv2')/members/microsoft.graph.aadUserConversationMember/$entity",
+ "@odata.type": "#microsoft.graph.aadUserConversationMember",
+ "id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
+ "roles": [],
+ "displayName": "Jacob Hancock",
+ "userId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "email": "jacob@contoso.com",
+ "tenantId": "a18103d1-a6ef-4f66-ac64-e4ef42ea8681"
} ``` + ## See also - [Add member to team](team-post-members.md)
v1.0 Channel Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-post.md
In the request body, supply a JSON representation of [channel](../resources/chan
## Response
-If successful, this method returns a `201 Created` response code and a [channel](../resources/channel.md) object in the response body.
+If successful, this method returns a `201 Created` response code and a [channel](../resources/channel.md) object in the response body for a channel with a **membershipType** value of `standard` or `private`. For a channel with a **membershipType** value of `shared`, this method returns a `202 Accepted` response code and a link to the [teamsAsyncOperation](../resources/teamsasyncoperation.md).
## Examples
Content-type: application/json
#### Response
-The following example shows the response.
+The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability.
Content-type: application/json
#### Response
-The following example shows the response.
+The following is an example of the response.
<!-- { "blockType": "response",
Content-type: application/json
#### Response
-The following example shows the response.
+The following is an example of the response.
<!-- { "blockType": "response",
Content-type: application/json
} ```
+### Example 5: Create a shared channel on behalf of a user
+
+#### Request
+
+The following example shows how to create a shared channel.
++
+<!-- {
+ "blockType": "request",
+ "name": "create_shared_channel"
+}-->
+
+```http
+POST https://graph.microsoft.com/v1.0/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels
+Content-type: application/json
+
+{
+ "displayName": "My First Shared Channel",
+ "description": "This is my first shared channel",
+ "membershipType": "shared",
+ "members": [
+ {
+ "@odata.type": "#microsoft.graph.aadUserConversationMember",
+ "user@odata.bind": "https://graph.microsoft.com/v1.0/users('7640023f-fe43-573f-9ff4-84a9efe4acd6')",
+ "roles": [
+ "owner"
+ ]
+ }
+ ]
+}
+```
+
+#### Response
+
+The following is an example of the response.
+<!-- {
+ "blockType": "response"
+} -->
+
+```http
+HTTP/1.1 202 Accepted
+Content-Type: application/json
+Content-Location: /teams/7640023f-fe43-4cc7-9bd3-84a9efe4acd6/operations/359d75f6-2bb8-4785-ab2d-377bf3d573fa
+Content-Length: 0
+```
++ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Channel Update Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-update-members.md
ms.prod: "microsoft-teams"
Namespace: microsoft.graph
-Update the role of a [conversationMember](../resources/conversationmember.md) in a [channel](../resources/channel.md). This operation is allowed only for channels with a **membershipType** value of `private`.
+Update the role of a [conversationMember](../resources/conversationmember.md) in a [channel](../resources/channel.md). This operation is allowed only for channels with a **membershipType** value of `private` or `shared`.
## Permissions
Content-type: application/json
"roles": ["owner"], "displayName": "John Doe", "userId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
- "email": null
+ "email": null,
+ "tenantId": "f2eea028-3898-4e55-b611-2e2d960f7512"
} ``` ## See also
v1.0 Device Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-update.md
Update the properties of a registered device.
Only certain properties of a device can be updated through approved Mobile Device Managment (MDM) apps. > [!IMPORTANT]
-> This API has a [known issue](/graph/known-issues#linux-based-devices-cant-be-updated-by-an-app-with-application-permissions). An app with application permissions can only update the **extensionAttributes** property for Linux-based devices, that is, where the **operationSystem** property is `linux`.
+> This API has a [known issue](/graph/known-issues#linux-based-devices-cant-be-updated-by-an-app-with-application-permissions). An app with application permissions cannot update the **extensionAttributes** property for Linux-based devices, that is, where the **operationSystem** property is `linux`.
## 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 Sharedwithchannelteaminfo Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/sharedwithchannelteaminfo-delete.md
+
+ Title: "Delete sharedWithChannelTeamInfo"
+description: "Unshare a channel with a team by deleting the corresponding sharedWithChannelTeamInfo resource."
+
+ms.localizationpriority: high
++
+# Delete sharedWithChannelTeamInfo
+Namespace: microsoft.graph
+
+Unshare a [channel](../resources/channel.md) with a [team](../resources/team.md) by deleting the corresponding [sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) resource. This operation is allowed only for channels with a **membershipType** value of `shared`.
+
+## 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) | ChannelMember.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | ChannelMember.ReadWrite.All |
++
+> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-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 `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_sharedwithchannelteaminfo"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/v1.0/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d82/channels/19%3A56eb04e133944cf69e603c5dac2d292e%40thread.skype/sharedWithTeams/ece6f0a1-5g39-498b-be79-edf6c8fc4d82
+```
+
+### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+## See also
+
+- [Remove member from channel](channel-delete-members.md)
+- [Remove member from team](team-delete-members.md)
v1.0 Sharedwithchannelteaminfo Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/sharedwithchannelteaminfo-get.md
+
+ Title: "Get sharedWithChannelTeamInfo"
+description: "Get a team that has been shared with a specified channel."
+
+ms.localizationpriority: high
++
+# Get sharedWithChannelTeamInfo
+Namespace: microsoft.graph
+
+Get a [team](../resources/sharedwithchannelteaminfo.md) that has been shared with a specified [channel](../resources/channel.md). This operation is allowed only for channels with a **membershipType** value of `shared`.
+
+## 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)|ChannelMember.Read.All, ChannelMember.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ChannelMember.Read.All, ChannelMember.ReadWrite.All |
+
+> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id}
+```
+
+## Optional query parameters
+This method does not support the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_sharedwithchannelteaminfo"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-5634-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2/sharedWithTeams/893075dd-2487-5634-925f-022c42e20265
+```
++
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.sharedWithChannelTeamInfo"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.sharedWithChannelTeamInfo",
+ "id": "2173de69-de69-2173-69de-732169de7321",
+ "tenantId": "b3246f44-b4gb-4627-96c6-25b18fa2c910",
+ "displayName": "Team contoso",
+ "isHostTeam": true
+ }
+}
+```
+
v1.0 Sharedwithchannelteaminfo List Allowedmembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/sharedwithchannelteaminfo-list-allowedmembers.md
+
+ Title: "List allowedMembers"
+description: "Get the list of conversationMembers who can access a shared channel."
+
+ms.localizationpriority: high
++
+# List allowedMembers
+Namespace: microsoft.graph
+
+Get the list of [conversationMembers](../resources/conversationmember.md) who can access a shared [channel](../resources/channel.md).
+
+This method does not return the following [conversationMembers](../resources/conversationmember.md) from the [team](../resources/team.md):
+- Users with `Guest` role
+- Users who are externally authenticated in the tenant
+
+> [!NOTE]
+> The membership ID returned by the server must be treated as an opaque string. The client should not try to parse or make any assumptions about this ID.
+>
+> The membership results can map to users from different tenants, as indicated in the response, in the future. The client should not assume that all members are only from the current 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) | ChannelMember.Read.All, ChannelMember.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | ChannelMember.Read.All, ChannelMember.ReadWrite.All |
++
+> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id}/allowedMembers
+```
+
+## Optional query parameters
+This method supports the `$select` and `$count` [OData query parameters](/graph/query-parameters) to customize the response.
+
+## 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 [conversationMember](../resources/conversationmember.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "list_conversationmember"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-5634-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2/sharedWithTeams/893075dd-2487-5634-925f-022c42e20265/allowedMembers
+```
+
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.conversationMember",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.conversationMember",
+ "id": "MmFiOWM3OTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyNlZWY5Y2IzNi0wNmRlLTQ2OWItODdjZC03MGY0Y2JlMzJkMTQ",
+ "roles": [
+ "owner"
+ ],
+ "displayName": "Eric Solomon",
+ "userId": "eef9cb36-06de-469b-87cd-70f4cbe32d14",
+ "email": "ericsol@fabrikam.com",
+ "tenantId": "df81db53-c7e2-418a-8803-0e68d4b88607"
+ },
+
+ {
+ "@odata.type": "#microsoft.graph.conversationMember",
+ "id": "MmFiOWMFxTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyNlZWY5Y2IzNi0wNmRlLTQ2OWItODdjZC03MGY0Y2JlMzJkMTQ",
+ "roles": [
+ "user"
+ ],
+ "displayName": "Caleb Foster",
+ "userId": "eef9cb36-06de-469b-87cd-70f4cbe32d14",
+ "email": "calfos@fabrikam.com",
+ "tenantId": "df81db53-c7e2-418a-8803-0e68d4b88607"
+ }
+ ]
+}
+```
+
+## See also
+
+- [List members of team](team-list-members.md)
v1.0 Sharedwithchannelteaminfo List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/sharedwithchannelteaminfo-list.md
+
+ Title: "List sharedWithChannelTeamInfo"
+description: "Get the list of teams that has been shared a specified channel."
+
+ms.localizationpriority: high
++
+# List sharedWithChannelTeamInfo
+Namespace: microsoft.graph
+
+Get the list of [teams](../resources/sharedwithchannelteaminfo.md) that has been shared a specified [channel](../resources/channel.md). This operation is allowed only for channels with a **membershipType** value of `shared`.
+
+## 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)|ChannelMember.Read.All, ChannelMember.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|ChannelMember.Read.All, ChannelMember.ReadWrite.All |
+
+> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /teams/{team-id}/channels/{channel-id}/sharedWithTeams
+```
+
+## Optional query parameters
+This method supports the `$filter` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
+
+## 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 [sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "list_sharedwithchannelteaminfo"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2/sharedWithTeams
+```
++
+### Response
+The following is an example of the response.
+<!-- {
+ "blockType": "response",
+ "@odata.type": "microsoft.graph.sharedWithChannelTeamInfo",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.sharedWithChannelTeamInfo",
+ "id": "2173de69-de69-2173-69de-732169de7321",
+ "tenantId": "b3246f44-b4gb-4627-96c6-25b18fa2c910",
+ "displayName": "Team Contoso",
+ "isHostTeam": true
+ },
+ {
+ "@odata.type": "#microsoft.graph.sharedWithChannelTeamInfo",
+ "id": "893075dd-2487-4122-86db-022c42e20265",
+ "displayName": "Team Fabrikam",
+ "isHostTeam": false,
+ "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910"
+ }
+ ]
+}
+```
+
v1.0 Signin Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/signin-get.md
Here is an example of the request.
"name": "get_signin" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/auditLogs/signIns/66ea54eb-6301-4ee5-be62-ff5a759b0100 ```
v1.0 Subscribedsku List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/subscribedsku-list.md
Here is an example of the request.
"blockType": "request", "name": "get_subscribedskus" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/subscribedSkus ```
v1.0 Team Delete Incomingchannels https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/team-delete-incomingchannels.md
+
+ Title: "Remove channel"
+description: "Remove an incoming channel."
+
+ms.localizationpriority: high
++
+# Remove channel
+Namespace: microsoft.graph
+
+Remove an incoming [channel](../resources/channel.md) (a **channel** shared with a **team**) from a [team](../resources/team.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) | Channel.Delete.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Channel.Delete.All |
++
+> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /teams/{team-id}/incomingChannels/{incoming-channel-id}/$ref
+```
+
+## 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 `204 No Content` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_sharedwithchannelteaminfo"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/v1.0/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d82/incomingChannels/19%3A56eb04e133944cf69e603c5dac2d292e%40thread.skype/$ref
+```
+
+### Response
+The following is an example of the response.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+## See also
+
+- [Remove member from channel](channel-delete-members.md)
+- [Remove member from team](team-delete-members.md)
v1.0 Team Get Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/team-get-members.md
Here is an example of the request.
"blockType": "request", "name": "team-get_member" } -->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d82/members/ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk= ```
v1.0 Team Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/team-get.md
The following is an example of a request.
"blockType": "request", "name": "get_team" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265 ```
v1.0 Team List Allchannels https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/team-list-allchannels.md
+
+ Title: "List allChannels"
+description: "Get the list of channels either in this team or shared with this team (incoming channels)."
+
+ms.localizationpriority: high
++
+# List allChannels
+Namespace: microsoft.graph
+
+Get the list of [channels](../resources/channel.md) either in this [team](../resources/team.md) or shared with this [team](../resources/team.md) (incoming channels).
+
+## 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) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All |
++
+> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /teams/{team-id}/allChannels
+```
+
+## Optional query parameters
+This method supports the `$filter` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
+
+### Use $select for better performance
+Populating the **email** and **moderationSettings** properties for a channel is an expensive operation that results in slow performance. Use `$select` to exclude the **email** and **moderationSettings** properties to improve performance.
+
+## 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 [channel](../resources/channel.md) objects in the response body. The response also includes the **@odata.id** property which can be used to access the channel and run other operations on the [channel](../resources/channel.md) object.
+
+> [!Note]
+> Currently, invoking the URL returned from the **@odata.id** property fails for cross-tenant shared channels. You can solve this issue if you remove the `/tenants/{tenant-id}` part from the URL before you call this API. For more details, see [Known issues with Microsoft Graph](/graph/known-issues#unable-to-access-a-cross-tenant-shared-channel-when-the-request-url-contains-tenantscross-tenant-id).
+
+## Examples
+
+### Example 1: List all channels
+
+#### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "list_all_channel"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/allChannels
+```
+
+#### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.channel",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.id": "https://graph.microsoft.com/v1.0/tenants/b3246f44-b4gb-4627-96c6-25b18fa2c910/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2",
+ "id": "19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2",
+ "createdDateTime": "2020-05-27T19:22:25.692Z",
+ "displayName": "General",
+ "description": "AutoTestTeam_20210311_150740.2550_fim3udfdjen9",
+ "membershipType": "standard",
+ "tenantId": "b3246f44-b4gb-4627-96c6-25b18fa2c910"
+ },
+ {
+ "@odata.id": "https://graph.microsoft.com/v1.0/tenants/b3246f44-b4gb-5678-96c6-25b18fa2c910/teams/893075dd-5678-5634-925f-022c42e20265/channels/19:561fbdbbfca848a484gabdf00ce9dbbd@thread.tacv",
+ "id": "19:561fbdbbfca848a484gabdf00ce9dbbd@thread.tacv2",
+ "createdDateTime": "2020-05-27T19:22:25.692Z",
+ "displayName": "Shared channel from Contoso",
+ "membershipType": "shared",
+ "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910"
+ }
+ ]
+}
+```
++
+### Example 2: List all shared channels
+
+#### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "list_all_shared_channel"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/allChannels?$filter=membershipType eq 'shared'
+```
++
+#### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.channel",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.id": "https://graph.microsoft.com/v1.0/tenants/b3246f44-b4gb-5678-96c6-25b18fa2c910/teams/893075dd-5678-5634-925f-022c42e20265/channels/19:561fbdbbfca848a484gabdf00ce9dbbd@thread.tacv",
+ "id": "19:561fbdbbfca848a484gabdf00ce9dbbd@thread.tacv2",
+ "createdDateTime": "2020-05-27T19:22:25.692Z",
+ "displayName": "Shared channel from Contoso",
+ "membershipType": "shared",
+ "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910"
+ }
+ ]
+}
+```
+
v1.0 Team List Incomingchannels https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/team-list-incomingchannels.md
+
+ Title: "List incomingChannels"
+description: "Get the list of incoming channels."
+
+ms.localizationpriority: high
++
+# List incomingChannels
+Namespace: microsoft.graph
+
+Get the list of incoming [channels](../resources/channel.md) (channels shared with a [team](../resources/team.md)).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All |
+
+> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /teams/{team-id}/incomingChannels
+```
+
+## Optional query parameters
+This method supports the `$filter` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
+
+## 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 [channel](../resources/channel.md) objects in the response body. The response also includes the **@odata.id** property which can be used to access the channel and run other operations on the [channel](../resources/channel.md) object.
+
+> [!Note]
+> Currently, invoking the URL returned from the **@odata.id** property fails for cross-tenant shared channels. You can solve this issue if you remove the `/tenants/{tenant-id}` part from the URL before you call this API. For more details, see [Known issues with Microsoft Graph](/graph/known-issues#unable-to-access-a-cross-tenant-shared-channel-when-the-request-url-contains-tenantscross-tenant-id).
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "list_channel"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/incomingChannels
+```
+
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.channel",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.id": "https://graph.microsoft.com/v1.0/tenants/b3246f44-b4gb-4627-96c6-25b18fa2c910/teams/893075dd-5678-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2",
+ "id": "19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2",
+ "createdDateTime": "2020-05-27T19:22:25.692Z",
+ "displayName": "Contoso Sales channel",
+ "description": "channel created in Contoso to be shared with other teams/tenants.",
+ "membershipType": "shared",
+ "tenantId": "b3246f44-b4gb-4627-96c6-25b18fa2c910"
+ }
+ ]
+}
+```
+
v1.0 Team List Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/team-list-installedapps.md
The following is an example of the request.
"name": "list_installed_apps_in_team" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/teams/6903fa93-605b-43ef-920e-77c4729f8258/installedApps ```
The following is an example of the request.
"name": "list_installed_teams_apps_expand" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/teams/6903fa93-605b-43ef-920e-77c4729f8258/installedApps?$expand=teamsAppDefinition ```
The following is an example of the request. In the example, the manifest ID of t
"blockType": "request", "name": "list_installed_apps_in_team_expand_filter_externalid" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/teams/acda442c-78d2-491b-8204-4ef5019c0193/installedApps?$expand=teamsApp,teamsAppDefinition&$filter=teamsApp/externalId eq 'cf1ba4c7-f94e-4d80-ba90-5594b641a8ee' ```
v1.0 Temporaryaccesspassauthenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/temporaryaccesspassauthenticationmethod-get.md
If successful, this method returns a `200 OK` response code and a collection of
"name": "get_temporaryAccessPassAuthenticationMethod" } -->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods/05267842-25b2-4b21-8abd-8e4982796f7f ```
v1.0 Temporaryaccesspassauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/temporaryaccesspassauthenticationmethodconfiguration-get.md
If successful, this method returns a `200 OK` response code and a [temporaryAcce
"name": "get_temporaryaccesspassauthenticationmethodconfiguration" } -->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass ```
v1.0 Termsofusecontainer List Agreements https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termsofusecontainer-list-agreements.md
If successful, this method returns a `200 OK` response code and collection of [a
"blockType": "request", "name": "get_agreements" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/identityGovernance/termsOfUse/agreements ```
v1.0 Threatassessmentrequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/threatassessmentrequest-get.md
The following is an example of the request.
"name": "get_mailassessmentrequest" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/informationProtection/threatAssessmentRequests/49c5ef5b-1f65-444a-e6b9-08d772ea2059 ```
The following is an example of the request.
"name": "get_emailfileassessmentrequest" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/informationProtection/threatAssessmentRequests/ab2ad9b3-2213-4091-ae0c-08d76ddbcacf ```
The following is an example of the request.
"name": "get_fileassessmentrequest" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/informationProtection/threatAssessmentRequests/18406a56-7209-4720-a250-08d772fccdaa ```
The following is an example of the request.
"name": "get_urlassessmentrequest" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/informationProtection/threatAssessmentRequests/723c35be-8b5a-47ae-29c0-08d76ddb7f5b ```
The following is an example of the request.
"name": "get_threatassessmentrequest_expand_results" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/informationProtection/threatAssessmentRequests/11922306-b25b-4605-ff0d-08d772fcf996?$expand=results ```
v1.0 Tokenissuancepolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/tokenissuancepolicy-list.md
The following is an example of the request.
"name": "tokenIssuancePolicies" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/policies/tokenIssuancePolicies ```
v1.0 Tokenlifetimepolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/tokenlifetimepolicy-list.md
The following is an example of the request.
"name": "get_tokenlifetimepolicies" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/policies/tokenLifetimePolicies ```
v1.0 Unifiedroleassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/unifiedroleassignment-get.md
The following is an example of the request.
}--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignments/lAPpYvVpN0KRkAEhdxReEJC2sEqbR_9Hr48lds9SGHI-1
+GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignments/lAPpYvVpN0KRkAEhdxReELhrmgjL6CxJqkHAeKoLUSA-11
``` # [C#](#tab/csharp)
Content-type: application/json
{ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#roleManagement/directory/roleAssignments/$entity",
- "id": "lAPpYvVpN0KRkAEhdxReEJC2sEqbR_9Hr48lds9SGHI-1",
- "roleDefinitionId": "62e90394-69f5-4237-9190-012177145e10",
- "principalId": "4ab0b690-479b-47ff-af8f-2576cf521872",
- "directoryScopeId": "28ca5a85-489a-49a0-b555-0a6d81e56f0"
+ "id": "lAPpYvVpN0KRkAEhdxReELhrmgjL6CxJqkHAeKoLUSA-1",
+ "principalId": "089a6bb8-e8cb-492c-aa41-c078aa0b5120",
+ "directoryScopeId": "/",
+ "roleDefinitionId": "62e90394-69f5-4237-9190-012177145e10"
} ```
The following is an example of the request with the `$expand` query parameter.
"name": "get_unifiedroleassignment" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignments/lAPpYvVpN0KRkAEhdxReEJC2sEqbR_9Hr48lds9SGHI-1?$expand=roleDefinition ```
v1.0 Unifiedroleassignmentschedule Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/unifiedroleassignmentschedule-filterbycurrentuser.md
If successful, this function returns a `200 OK` response code and a [unifiedRole
"name": "unifiedroleassignmentschedulethis.filterbycurrentuser" } -->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignmentSchedules/filterByCurrentUser(on='principal') ```
v1.0 Unifiedroleassignmentschedule Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/unifiedroleassignmentschedule-get.md
If successful, this method returns a `200 OK` response code and an [unifiedRoleA
"name": "get_unifiedroleassignmentschedule" } -->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignmentSchedules/95c690fb-3eb3-4942-a03f-4524aed6f31e ```
v1.0 Unifiedroleassignmentschedulerequest Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/unifiedroleassignmentschedulerequest-filterbycurrentuser.md
If successful, this function returns a `200 OK` response code and a [unifiedRole
"name": "unifiedroleassignmentschedulerequestthis.filterbycurrentuser" } -->
-```msgraph-interactive
+``` http
GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignmentScheduleRequests/filterByCurrentUser(on='principal') ```
v1.0 Unifiedroleassignmentschedulerequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/unifiedroleassignmentschedulerequest-get.md
If successful, this method returns a `200 OK` response code and an [unifiedRoleA
"name": "get_unifiedroleassignmentschedulerequest" } -->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignmentScheduleRequests/95c690fb-3eb3-4942-a03f-4524aed6f31e ```
Content-Type: application/json
"name": "get_unifiedroleassignmentschedulerequest_expand_relationships" } -->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignmentScheduleRequests/95c690fb-3eb3-4942-a03f-4524aed6f31e?$select=principalId,action,roleDefinitionId&$expand=roleDefinition,activatedUsing,principal,targetSchedule ```
v1.0 Unifiedroledefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/unifiedroledefinition-get.md
The following is an example of the request.
"name": "get_custom_role_unifiedroledefinition" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleDefinitions/f189965f-f560-4c59-9101-933d4c87a91a ```
The following is an example of the request.
}--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleDefinitions/fdd7a751-b60b-444a-984c-02652fe8fa1c
+GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleDefinitions/3a2c62db-5318-420d-8d74-23affee5d9d5
``` # [C#](#tab/csharp)
v1.0 Unifiedrolemanagementpolicyassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/unifiedrolemanagementpolicyassignment-get.md
If successful, this method returns a `200 OK` response code and an [unifiedRoleM
"name": "get_unifiedrolemanagementpolicyassignment" } -->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/policies/roleManagementPolicyAssignments/Directory_cab01047-8ad9-4792-8e42-569340767f1b_70c808b5-0d35-4863-a0ba-07888e99d448_62e90394-69f5-4237-9190-012177145e10 ```
Content-Type: application/json
"name": "get_unifiedrolemanagementpolicyassignment_expand_all_relationships" } -->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/policies/roleManagementPolicyAssignments/Directory_cab01047-8ad9-4792-8e42-569340767f1b_70c808b5-0d35-4863-a0ba-07888e99d448_62e90394-69f5-4237-9190-012177145e10?$expand=policy($expand=rules) ```
v1.0 User List Agreementacceptances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-list-agreementacceptances.md
If successful, this method returns a `200 OK` response code and a collection of
"blockType": "request", "name": "get_agreementacceptances" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/me/agreementAcceptances ```
v1.0 User List Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-list-approleassignments.md
Here is an example of the request to retrieve the app roles that have been assig
}--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/users/cdb555e3-b33e-4fd5-a427-17fadacbdfa7/appRoleAssignments
+GET https://graph.microsoft.com/v1.0/users/6e7b768e-07e2-4810-8459-485f84f8f204/appRoleAssignments
``` # [C#](#tab/csharp)
Here is an example of the request to retrieve the app roles that have been assig
"name": "user_get_approleassignments_filterby_resourceId" }-->
-```msgraph-interactive
+```http
GET https://graph.microsoft.com/v1.0/users/cdb555e3-b33e-4fd5-a427-17fadacbdfa7/appRoleAssignments?$filter=resourceId eq 8e881353-1735-45af-af21-ee1344582a4d ```
v1.0 User List Directreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-list-directreports.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
+|Delegated (work or school account) | User.Read and User.ReadBasic.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
|Delegated (personal Microsoft account) | Not supported | |Application | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
v1.0 User List Joinedteams https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-list-joinedteams.md
Namespace: microsoft.graph
Get the [teams](../resources/team.md) in Microsoft Teams that the user is a direct member of.
+>**Note:** This API doesn't return the host team of the shared channel that the user is a direct member of. Use the [List associated teams](../api/associatedteaminfo-list.md) API, to retrieve the host teams of the shared channels that the user has access to.
## 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
|Delegated (personal Microsoft account) | Not supported. | |Application | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All**, Directory.ReadWrite.All** |
-> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
+> **Note:** Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
> **Note:** Currently, with user delegated permissions, this operation only works for the `me` user. With application permissions, it works for all users by specifying the specific user ID (`me` alias is not supported with application permissions). For details, see [Known issues](/graph/known-issues#microsoft-teams-users-list-of-joined-teams-preview).
Content-type: application/json
## See also - [List all teams](/graph/teams-list-all-teams) - [Get team](../api/team-get.md)
+- [List associated teams](../api/associatedteaminfo-list.md)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 User List Manager https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-list-manager.md
GET /users/{id | userPrincipalName}/manager
Get the management chain: <!-- { "blockType": "ignored" } --> ```http
-GET /me?$expand=manager
-GET /users?$expand=manager($levels=n)
+GET /users?$expand=manager
GET /users/{id | userPrincipalName}/?$expand=manager($levels=n) ```
This method supports the `$select` and `$expand` [OData query parameters](/graph
> + The `n` value of `$levels` can be `max` (to return all managers) or a number between 1 and 1000. > + When the `$levels` parameter is not specified, only the immediate manager is returned. > + You can specify `$select` inside `$expand` to select the individual manager's properties. The `$levels` parameter is required: `$expand=manager($levels=max;$select=id,displayName)`.
+> + `$levels` parameter is only supported on a single user (`/users/{id}` or `me` endpoints) and not on the entire list of users.
+> + `$levels` requires the **ConsistencyLevel** header set to `eventual` and `$count=true` in query string. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers
Content-type: application/json
### Example 2: Get manager chain up to the root level
-The following example shows a request to get the manager chain up to the root level. This request requires the **ConsistencyLevel** header set to `eventual` because `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+The following example shows a request to get the manager chain up to the root level.
#### Request -- # [HTTP](#tab/http) <!-- { "blockType": "request",
v1.0 User List Oauth2permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-list-oauth2permissiongrants.md
Here is an example of the request.
}--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/users/7d54cb02-aaa3-4016-9f9c-a4b49422dd9b/oauth2PermissionGrants
+GET https://graph.microsoft.com/v1.0/users/6e7b768e-07e2-4810-8459-485f84f8f204/oauth2PermissionGrants
``` # [C#](#tab/csharp)
v1.0 Associatedteaminfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/associatedteaminfo.md
+
+ Title: "associatedTeamInfo resource type"
+description: "Represents a team that is associated with a user."
+
+ms.localizationpriority: high
++
+# associatedTeamInfo resource type
+
+Namespace: microsoft.graph
+
+Represents a [team](team.md) that is associated with a [user](../resources/user.md).
+
+Currently, a [user](../resources/user.md) can be associated with a [team](../resources/team.md) in two different ways:
+* A [user](../resources/user.md) can be a direct member of a [team](../resources/team.md).
+* A [user](../resources/user.md) can be a member of a shared [channel](../resources/channel.md) that is hosted inside a [team](../resources/team.md).
+
+Inherits from [teamInfo](../resources/teaminfo.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List associatedTeamInfo](../api/associatedteaminfo-list.md)|[associatedTeamInfo](../resources/associatedteaminfo.md) collection|Get the list of [teams](../resources/associatedteaminfo.md) in Microsoft Teams that a [user](../resources/user.md) is associated with.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The name of the [team](team.md). Inherited from [teamInfo](../resources/teaminfo.md).|
+|id|String|The unique identifier for the [team](team.md). Read-only.|
+|tenantId|String|The ID of the Azure Active Directory tenant. Inherited from [teamInfo](../resources/teaminfo.md).|
++
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.associatedTeamInfo",
+ "baseType": "microsoft.graph.teamInfo",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.associatedTeamInfo",
+ "displayName": "String",
+ "id": "String (identifier)",
+ "tenantId": "String"
+}
+```
+
+## See also
+- [Get team](../api/team-get.md)
v1.0 Channel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/channel.md
where files are shared, and where tabs are added.
| Method | Return Type |Description| |:|:--|:-|
-|[List channels](../api/channel-list.md) | [channel](channel.md) collection | Get the list of channels in this team.|
+|[List channels](../api/channel-list.md) | [channel](channel.md) collection | Get the list of channels in a team.|
+|[List incoming channels](../api/team-list-incomingchannels.md)|[channel](../resources/channel.md) collection|Get the list of incoming [channels](../resources/channel.md) (channels shared with a [team](../resources/team.md)).|
+|[List all channels](../api/team-list-allchannels.md)|[channel](../resources/channel.md) collection|Get the list of [channels](../resources/channel.md) either in a [team](../resources/team.md) or shared with a [team](../resources/team.md) (incoming channels).|
|[Create channel](../api/channel-post.md) | [channel](channel.md) | Create a new channel by including the display name and description.| |[Get channel](../api/channel-get.md) | [channel](channel.md) | Read properties and relationships of the channel.| |[Update channel](../api/channel-patch.md) | [channel](channel.md) | Update properties of the channel.|
where files are shared, and where tabs are added.
|[Get files folder](../api/channel-get-filesfolder.md)| [driveItem](driveitem.md) | Retrieves the details of the SharePoint folder where the files for the channel are stored. | |[List tabs](../api/channel-list-tabs.md) | [teamsTab](teamstab.md) | Lists tabs pinned to a channel.| |[List channel members](../api/channel-list-members.md) | [conversationMember](conversationmember.md) collection | Get the list of members in a channel.|
-|[Add channel member](../api/channel-post-members.md) | [conversationMember](conversationmember.md) | Add a member to a channel. Only supported for `channel` with membershipType of `private`.|
+|[Add channel member](../api/channel-post-members.md) | [conversationMember](conversationmember.md) | Add a member to a channel. Only supported for channels with a **membershipType** of `private` or `shared`.|
|[Get channel member](../api/channel-get-members.md) | [conversationMember](conversationmember.md) collection | Get a member in a channel.|
-|[Update channel member's role](../api/channel-update-members.md) | [conversationMember](conversationmember.md) | Update the properties of a member of the channel. Only supported for channel with membershipType of `private`.|
-|[Remove channel member](../api/channel-delete-members.md) | None | Delete a member from a channel. Only supported for `channelType` of `private`.|
+|[Update channel member's role](../api/channel-update-members.md) | [conversationMember](conversationmember.md) | Update the properties of a member of the channel. Only supported for channels with a **membershipType** of `private` or `shared`.|
+|[Remove channel member](../api/channel-delete-members.md) | None | Delete a member from a channel. Only supported for channels with a **membershipType** of `private` or `shared`.|
|[Complete migration](../api/channel-completemigration.md)|[channel](channel.md)| Removes the migration mode from the channel and makes the channel available to users to post and read messages.| |[List tabs in channel](../api/channel-list-tabs.md) | [teamsTab](teamstab.md) | List tabs pinned to a channel.| |[Add tab to channel](../api/channel-post-tabs.md) | [teamsTab](teamstab.md) | Add (pin) a tab to a channel.|
where files are shared, and where tabs are added.
|[Remove tab from channel](../api/channel-delete-tabs.md) | None | Remove (unpin) a tab from a channel.| |[Provision channel email address](../api/channel-provisionemail.md) |[provisionChannelEmailResult](../resources/provisionchannelemailresult.md)| Provision an email address for the channel.| |[Remove channel email address](../api/channel-removeemail.md) | None | Remove the email address of the channel.|
+|[Remove incoming channel](../api/team-delete-incomingchannels.md) | None| Remove an incoming [channel](../resources/channel.md) (a **channel** shared with a **team**) from a [team](../resources/team.md).|
+|[List teams sharing a channel](../api/sharedwithchannelteaminfo-list.md)|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) collection|Get the list of [teams](../resources/sharedwithchannelteaminfo.md) that has been shared a specified [channel](../resources/channel.md).|
+|[Get team sharing a channel](../api/sharedwithchannelteaminfo-get.md)|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md)|Get a [team](../resources/sharedwithchannelteaminfo.md) which has been shared a specified [channel](../resources/channel.md).|
+|[Unshare channel with team](../api/sharedwithchannelteaminfo-delete.md)|None|Unshare a [channel](../resources/channel.md) with a [team](../resources/team.md) by deleting the corresponding [sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) resource.|
+|[List allowed members](../api/sharedwithchannelteaminfo-list-allowedmembers.md)|[conversationMember](../resources/conversationmember.md) collection|Get the list of [conversationMembers](../resources/conversationmember.md) who can access a shared [channel](../resources/channel.md).|
+|[Check user access](../api/channel-doesuserhaveaccess.md)|Boolean|Determine whether a [user](../resources/useridentity.md) has access to a shared [channel](../resources/channel.md).|
## Properties
where files are shared, and where tabs are added.
|isFavoriteByDefault|Boolean|Indicates whether the channel should automatically be marked 'favorite' for all members of the team. Can only be set programmatically with [Create team](../api/team-post.md). Default: `false`.| |email|String| The email address for sending messages to the channel. Read-only.| |webUrl|String|A hyperlink that will go to the channel in Microsoft Teams. This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only.|
-|membershipType|[channelMembershipType](../resources/enums.md#channelmembershiptype-values)|The type of the channel. Can be set during creation and can't be changed. Possible values are: `standard` - Channel inherits the list of members of the parent team; `private` - Channel can have members that are a subset of all the members on the parent team.
+|membershipType|[channelMembershipType](../resources/enums.md#channelmembershiptype-values)|The type of the channel. Can be set during creation and can't be changed. The possible values are: `standard`, `private`, `unknownFutureValue`, `shared`. The default value is `standard`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `shared`.|
|createdDateTime|dateTimeOffset|Read only. Timestamp at which the channel was created.|
+|tenantId |string | The ID of the Azure Active Directory tenant. |
### Instance attributes
For a POST request example, see [Request (create channel in migration state)](/m
|members|[conversationMember](conversationmember.md) collection|A collection of membership records associated with the channel.| |[filesFolder](../api/channel-get-filesfolder.md)|[driveItem](driveitem.md)|Metadata for the location where the channel's files are stored.| |operations|[teamsAsyncOperation](teamsasyncoperation.md) collection| The async operations that ran or are running on this team. |
+|sharedWithTeams|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) collection|A collection of teams with which a channel is shared.|
## JSON representation
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/enums.md
Possible values for user account types (group membership), per Windows definitio
| standard | 0 |Channel inherits the list of members of the parent team.| | private | 1 |Channel can have members that are a subset of all the members on the parent team.| | unknownFutureValue | 2 | |
+| shared | 3 |Members can be directly added to the channel without adding them to the team.|
### wellknownListName values | Member |:-
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/group.md
This resource supports:
| **User settings** | | | | [addFavorite](../api/group-addfavorite.md) | None | Add the group to the list of the signed-in user's favorite groups. Supported for only Microsoft 365 groups. | | [removeFavorite](../api/group-removefavorite.md) | None | Remove the group from the list of the signed-in user's favorite groups. Supported for only Microsoft 365 groups. |
-| [List memberOf](../api/group-list-memberof.md) | [directoryObject](directoryobject.md) collection | Get the groups and administrative units that this user is a direct member of, from the **memberOf** navigation property. |
+| [List memberOf](../api/group-list-memberof.md) | [directoryObject](directoryobject.md) collection | Get the groups and administrative units that this user is a direct member of, from the **memberOf** navigation property. |
+| [List joinedTeams](../api/user-list-joinedteams.md) | [group](group.md) collection | Get the Microsoft Teams that the user is a direct member of. |
+| [List associated teams](../api/associatedteaminfo-list.md) | [associatedTeamInfo](associatedteaminfo.md) collection | Get the list of [associatedTeamInfo](associatedteaminfo.md) objects in Microsoft Teams that a [user](user.md) is associated with. |
| [subscribeByMail](../api/group-subscribebymail.md) | None | Set the isSubscribedByMail property to `true`. Enabling the signed-in user to receive email conversations. Supported for only Microsoft 365 groups. | | [unsubscribeByMail](../api/group-unsubscribebymail.md) | None | Set the isSubscribedByMail property to `false`. Disabling the signed-in user from receive email conversations. Supported for only Microsoft 365 groups. | | [resetUnseenCount](../api/group-resetunseencount.md) | None | Reset the unseenCount to 0 of all the posts that the signed-in user has not seen since their last visit. Supported for only Microsoft 365 groups. |
v1.0 Sharedwithchannelteaminfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/sharedwithchannelteaminfo.md
+
+ Title: "sharedWithChannelTeamInfo resource type"
+description: "Represents information for a team with which a channel is shared."
+
+ms.localizationpriority: high
++
+# sharedWithChannelTeamInfo resource type
+
+Namespace: microsoft.graph
+
+Represents information for a [team](team.md) with which a channel is shared. A [team](team.md) can be shared multiple channels.
++
+Inherits from [teamInfo](../resources/teaminfo.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List sharedWithChannelTeamInfo](../api/sharedwithchannelteaminfo-list.md)|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) collection|Get the list of [teams](../resources/sharedwithchannelteaminfo.md) that has been shared a specified [channel](../resources/channel.md).|
+|[Get sharedWithChannelTeamInfo](../api/sharedwithchannelteaminfo-get.md)|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md)|Get a [team](../resources/sharedwithchannelteaminfo.md) which has been shared a specified [channel](../resources/channel.md).|
+|[Delete sharedWithChannelTeamInfo](../api/sharedwithchannelteaminfo-delete.md)|None|Unshare a [channel](../resources/channel.md) with a [team](../resources/team.md) by deleting the corresponding [sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) resource.|
+|[List allowedMembers](../api/sharedwithchannelteaminfo-list-allowedmembers.md)|[conversationMember](../resources/conversationmember.md) collection|Get the list of [conversationMembers](../resources/conversationmember.md) who can access a shared [channel](../resources/channel.md).|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The name of the [team](team.md). Inherited from [teamInfo](../resources/teaminfo.md).|
+|id|String|The unique identifier for the [team](team.md). Read-only.|
+|isHostTeam|Boolean|Indicates whether the [team](team.md) is the host of the [channel](channel.md).|
+|tenantId|String|The ID of the Azure Active Directory tenant. Inherited from [teamInfo](../resources/teaminfo.md).|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|allowedMembers|[conversationMember](../resources/conversationmember.md) collection|A collection of team members who have access to the shared channel.|
++
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.sharedWithChannelTeamInfo",
+ "baseType": "microsoft.graph.teamInfo",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.sharedWithChannelTeamInfo",
+ "displayName": "String",
+ "id": "String (identifier)",
+ "isHostTeam": "Boolean",
+ "tenantId": "String"
+}
+```
+
v1.0 Team https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/team.md
For more information about working with groups and members in teams, see [Use th
|[Unarchive team](../api/team-unarchive.md) | [teamsAsyncOperation](../resources/teamsasyncoperation.md) |Restore the team to a read-write state. | |[Clone team](../api/team-clone.md) | [teamsAsyncOperation](../resources/teamsasyncoperation.md) |Copy the team and its associated group. | |[List your teams](../api/user-list-joinedteams.md) | [team](team.md) collection | List the teams you are a member of. |
+|[List associated teams](../api/associatedteaminfo-list.md) | [associatedTeamInfo](associatedteaminfo.md) collection | Get the list of [teams](../resources/associatedteaminfo.md) in Microsoft Teams that a [user](../resources/user.md) is associated with. |
|[Complete migration](../api/team-completemigration.md)|[team](team.md)| Removes migration mode from the team and makes the team available to users to post and read messages.|
+|[List all channels](../api/team-list-allchannels.md)|[channel](../resources/channel.md) collection|Get the list of [channels](../resources/channel.md) either in this [team](../resources/team.md) or shared with this [team](../resources/team.md) (incoming channels).|
+|[List channels](../api/channel-list.md)|[channel](../resources/channel.md) collection|Get the list of [channels](../resources/channel.md) in a **team**.|
+|[List incoming channels](../api/team-list-incomingchannels.md)|[channel](../resources/channel.md) collection|Get the list of incoming [channels](../resources/channel.md) (channels shared with a [team](../resources/team.md)).|
+|[Remove incoming channel](../api/team-delete-incomingchannels.md) | None| Remove an incoming [channel](../resources/channel.md) (a **channel** shared with a **team**) from a [team](../resources/team.md).|
|[List apps installed in team](../api/team-list-installedapps.md) | [teamsAppInstallation](teamsappinstallation.md) collection | List apps installed in a team.| |[Add app to team](../api/team-post-installedapps.md) |None | Add (install) an app to a team.| |[Get app installed in team](../api/team-get-installedapps.md) | [teamsAppInstallation](teamsappinstallation.md) | Get the specified app installed in a team.|
For more information about working with groups and members in teams, see [Use th
|messagingSettings|[teamMessagingSettings](teammessagingsettings.md) |Settings to configure messaging and mentions in the team.| |webUrl|string (readonly) | A hyperlink that will go to the team in the Microsoft Teams client. This is the URL that you get when you right-click a team in the Microsoft Teams client and select **Get link to team**. This URL should be treated as an opaque blob, and not parsed. | |createdDateTime|dateTimeOffset|Timestamp at which the team was created.|
+|tenantId |string | The ID of the Azure Active Directory tenant. |
### Instance attributes
For a POST request example, see [Request (create team in migration state)](/micr
| Relationship | Type | Description | |:|:--|:-|
+|allChannels|[channel](channel.md) collection|List of channels either hosted in or shared with the team (incoming channels).|
|channels|[channel](channel.md) collection|The collection of channels and messages associated with the team.|
+|incomingChannels|[channel](channel.md) collection|List of [channels](../resources/channel.md) shared with the team.|
|installedApps|[teamsAppInstallation](teamsappinstallation.md) collection|The apps installed in this team.| |members|[conversationMember](../resources/conversationmember.md) collection|Members and owners of the team.| |operations|[teamsAsyncOperation](teamsasyncoperation.md) collection| The async operations that ran or are running on this team. |
v1.0 Teaminfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/teaminfo.md
+
+ Title: "teamInfo resource type"
+description: "Represents a team with basic information."
+
+ms.localizationpriority: high
++
+# teamInfo resource type
+
+Namespace: microsoft.graph
+
+Represents a [team](team.md) with basic information.
+
+Base type of [associatedTeamInfo](associatedteaminfo.md) and [sharedWithChannelTeamInfo](sharedwithchannelteaminfo.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The name of the [team](team.md).|
+|id|String|The unique identifier for the [team](team.md). Read-only.|
+|tenantId|String|The ID of the Azure Active Directory tenant.|
++
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.teamInfo",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.teamInfo",
+ "displayName": "String",
+ "id": "String (identifier)",
+ "tenantId": "String"
+}
+```
v1.0 Teams Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/teams-api-overview.md
Microsoft Teams is a chat-based workspace in Microsoft 365 that provides built-i
| Resource | Methods | |:|:--|
-|[team](../resources/team.md)| [List your teams](../api/user-list-joinedteams.md), [list all teams](/graph/teams-list-all-teams), [create](../api/team-put-teams.md), [read](../api/team-get.md), [update](../api/team-update.md), [delete](../api/group-delete.md), [clone](../api/team-clone.md), [archive](../api/team-archive.md), [unarchive](../api/team-unarchive.md) |
+|[team](../resources/team.md)| [List your teams](../api/user-list-joinedteams.md), [list associated teams](../api/associatedteaminfo-list.md), [list all teams](/graph/teams-list-all-teams), [create](../api/team-put-teams.md), [read](../api/team-get.md), [update](../api/team-update.md), [delete](../api/group-delete.md), [clone](../api/team-clone.md), [archive](../api/team-archive.md), [unarchive](../api/team-unarchive.md) |
|[group](../resources/group.md)| [Add member](../api/group-post-members.md),ΓÇ»[remove member](../api/group-delete-members.md), [add owner](../api/group-post-owners.md),ΓÇ»[remove owner](../api/group-delete-owners.md), [get files](drive.md), [get notebook](../resources/notebook.md), [get plans](plannergroup.md), [get calendar](event.md) | |[channel](../resources/channel.md)|[List](../api/channel-list.md), [create](../api/channel-post.md), [read](../api/channel-get.md), [update](../api/channel-patch.md), [delete](../api/channel-delete.md)| |[teamsTab](../resources/teamstab.md) |[List](../api/channel-list-tabs.md), [create](../api/channel-post-tabs.md), [read](../api/channel-get-tabs.md), [update](../api/channel-patch-tabs.md), [delete](../api/channel-delete-tabs.md) |
v1.0 Teamsasyncoperationtype https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/teamsasyncoperationtype.md
Types of [teamsAsyncOperation](teamsasyncoperation.md). Members will be added he
|unarchiveTeam|Operation to restore an archived team.| |createTeam|Operation to create a team from scratch.| |unknownFutureValue| Evolvable enumeration sentinel value. Do not use. |
+|teamifyGroup |Operation to create a team from a group. |
+|createChannel |Operation to create a channel in a team. |
v1.0 Userteamwork https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/userteamwork.md
Title: "userTeamwork resource type"
-description: "A container for Microsoft Teams features available per user. "
+description: "A container for Microsoft Teams features available per user."
doc_type: resourcePageType ms.localizationpriority: high
A container for the range of Microsoft Teams functionalities that are available
| Relationship | Type | Description | |:|:--|:-|
+|associatedTeams|[associatedTeamInfo](associatedteaminfo.md) collection| The list of [associatedTeamInfo](associatedteaminfo.md) objects that a [user](user.md) is associated with.|
|installedApps|[teamsAppInstallation](teamsappinstallation.md) collection|The apps installed in the personal scope of this user.| ## JSON representation
The following is a JSON representation of the resource.
{ "id": "string" }- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
items: - name: List joined teams href: api/user-list-joinedteams.md
+ - name: List associated teams
+ href: api/associatedteaminfo-list.md
- name: List member of href: api/user-list-memberof.md - name: List transitive member of
items:
href: api/group-delta.md - name: Assign license href: api/group-assignlicense.md
+ - name: List joined teams
+ href: api/user-list-joinedteams.md
+ - name: List associated teams
+ href: api/associatedteaminfo-list.md
- name: Group setting href: resources/groupsetting.md items:
items:
href: api/team-clone.md - name: List your teams href: api/user-list-joinedteams.md
+ - name: List your associated teams
+ href: api/associatedteaminfo-list.md
- name: Get primary channel href: api/team-get-primarychannel.md - name: Get team photo
items:
href: api/group-delete.md - name: List joined teams href: api/user-list-joinedteams.md
+ - name: List associated teams
+ href: api/associatedteaminfo-list.md
- name: List members href: api/group-list-members.md - name: Add member
items:
- name: Channel href: resources/channel.md items:
+ - name: List all channels
+ href: api/team-list-allchannels.md
- name: List channels href: api/channel-list.md
+ - name: List incoming channels
+ href: api/team-list-incomingchannels.md
- name: Create channel href: api/channel-post.md - name: Get channel
items:
href: api/channel-patch.md - name: Delete channel href: api/channel-delete.md
+ - name: Remove incoming channel
+ href: api/team-delete-incomingchannels.md
- name: Add member href: api/channel-post-members.md - name: Complete migration for channel
items:
href: api/channel-update-members.md - name: Update message href: api/chatmessage-update.md
+ - name: Check user access
+ href: api/channel-doesuserhaveaccess.md
+ - name: List teams sharing a channel
+ href: api/sharedwithchannelteaminfo-list.md
+ - name: Get team sharing a channel
+ href: api/sharedwithchannelteaminfo-get.md
+ - name: Unshare channel with team
+ href: api/sharedwithchannelteaminfo-delete.md
+ - name: List allowed members
+ href: api/sharedwithchannelteaminfo-list-allowedmembers.md
- name: Chat href: resources/chat.md items: