Skip to content

Commit 7ad2bfc

Browse files
DanipocketDanipocket
authored
Merge pull request #28439 from microsoftgraph/users/devjha/Enable-Apps-in-Channels
Enable apps in channel - v1.0
2 parents 41596de + 39b06c6 commit 7ad2bfc

15 files changed

Lines changed: 557 additions & 14 deletions

‎api-reference/beta/api/channel-list-enabledapps.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Don't supply a request body for this method.
5151

5252
## Response
5353

54-
If successful, this method returns a `200 OK` response code and a collection of [teamsApp](../resources/teamsapp.md) objects in the response body. The response also includes the **@odata.id** property which can be used to access the **teamsApp** and run other operations on the [teamsApp](../resources/teamsApp.md) object.
54+
If successful, this method returns a `200 OK` response code and a collection of [teamsApp](../resources/teamsapp.md) objects in the response body. The response also includes the **@odata.id** property which can be used to access the **teamsApp** and run other operations on the [teamsApp](../resources/teamsapp.md) object.
5555

5656
## Examples
5757

‎api-reference/beta/resources/teamsapp.md‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -43,11 +43,12 @@ Users can see these apps in the Microsoft Teams Store, and these apps can be ins
4343

4444
### teamsAppDistributionMethod values
4545

46-
|Member|Value|Description|
47-
|:---|:---|:---|
48-
|store|0| The app is available to all tenants through the Microsoft Teams app store.|
49-
|organization|1|The app is available only in this tenant.|
50-
|sideloaded|2|The app is available only to the user/team its installed to.|
46+
|Member|Description|
47+
|:---|:---|
48+
|store| The app is available to all tenants through the Microsoft Teams app store.|
49+
|organization|The app is available only in this tenant.|
50+
|sideloaded|The app is available only to the user or team it's installed to.|
51+
|unknownFutureValue|Evolvable enumeration sentinel value. Don't use. |
5152

5253
## Relationships
5354

‎api-reference/v1.0/api/channel-delete-enabledapps.md‎

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
title: "Remove teamsApp"
3+
description: "Remove a teamsApp that disables an app in the specified channel within a team."
4+
author: "devjha-ms"
5+
ms.date: 03/16/2026
6+
ms.localizationpriority: medium
7+
ms.subservice: "teams"
8+
doc_type: apiPageType
9+
---
10+
11+
# Remove teamsApp
12+
13+
Namespace: microsoft.graph
14+
15+
Remove a [teamsApp](../resources/teamsapp.md) that disables an [app](../resources/teamsapp.md) in the specified [channel](../resources/channel.md) within a [team](../resources/team.md). This operation is allowed only for channels with a **membershipType** value of `shared`.
16+
17+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
18+
19+
## Permissions
20+
21+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "channel_delete_enabledapps"
26+
}
27+
-->
28+
29+
[!INCLUDE [permissions-table](../includes/permissions/channel-delete-enabledapps-permissions.md)]
30+
31+
## HTTP request
32+
33+
<!-- {
34+
"blockType": "ignored"
35+
}
36+
-->
37+
38+
``` http
39+
DELETE /teams/{team-id}/channels/{channel-id}/enabledApps/{app-id}/$ref
40+
```
41+
42+
## Request headers
43+
44+
|Name|Description|
45+
|:---|:---|
46+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
47+
48+
## Request body
49+
50+
Don't supply a request body for this method.
51+
52+
## Response
53+
54+
If successful, this method returns a `204 No Content` response code.
55+
56+
## Examples
57+
58+
### Request
59+
60+
The following example shows a request.
61+
62+
<!-- {
63+
"blockType": "request",
64+
"name": "delete_channel_enabledapps",
65+
"sampleKeys": ["893075dd-2487-4122-925f-022c42e20265", "19:561fbdbbfca848a3a8df3ffe558b1c1@thread.tacv2", "b1c5353a-7aca-41b3-830f-27d5218fe0e5"]
66+
}
67+
-->
68+
69+
``` http
70+
DELETE https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a3a8df3ffe558b1c1@thread.tacv2/enabledApps/b1c5353a-7aca-41b3-830f-27d5218fe0e5/$ref
71+
```
72+
73+
### Response
74+
75+
The following example shows the response.
76+
77+
<!-- {
78+
"blockType": "response",
79+
"truncated": true
80+
}
81+
-->
82+
83+
``` http
84+
HTTP/1.1 204 No Content
85+
```

‎api-reference/v1.0/api/channel-list-enabledapps.md‎

Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
---
2+
title: "List enabledApps"
3+
description: "Get a list of the enabled apps in the specified channel within a team."
4+
author: "devjha-ms"
5+
ms.date: 03/16/2026
6+
ms.localizationpriority: medium
7+
ms.subservice: "teams"
8+
doc_type: apiPageType
9+
---
10+
11+
# List enabledApps
12+
13+
Namespace: microsoft.graph
14+
15+
Get a list of the [enabled apps](../resources/teamsapp.md) in the specified [channel](../resources/channel.md) within a [team](../resources/team.md).
16+
17+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
18+
19+
## Permissions
20+
21+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
22+
23+
<!-- { "blockType": "permissions", "name": "channel_list_enabledapps" } -->
24+
[!INCLUDE [permissions-table](../includes/permissions/channel-list-enabledapps-permissions.md)]
25+
26+
## HTTP request
27+
28+
<!-- {
29+
"blockType": "ignored"
30+
}
31+
-->
32+
33+
``` http
34+
GET /teams/{team-id}/channels/{channel-id}/enabledApps
35+
```
36+
37+
## Optional query parameters
38+
39+
This method supports the `$filter` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
40+
41+
## Request headers
42+
43+
|Name|Description|
44+
|:---|:---|
45+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
46+
47+
## Request body
48+
49+
Don't supply a request body for this method.
50+
51+
## Response
52+
53+
If successful, this method returns a `200 OK` response code and a collection of [teamsApp](../resources/teamsapp.md) objects in the response body. The response also includes the **@odata.id** property which can be used to access the **teamsApp** and run other operations on the [teamsApp](../resources/teamsapp.md) object.
54+
55+
## Examples
56+
57+
### Request
58+
59+
The following example shows a request.
60+
61+
<!-- {
62+
"blockType": "request",
63+
"name": "list_channel_enabledapps",
64+
"sampleKeys": ["893075dd-2487-4122-925f-022c42e20265", "19:561fbdbbfca848a3a8df3ffe558b1c1@thread.tacv2"]
65+
}
66+
-->
67+
68+
``` http
69+
GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a3a8df3ffe558b1c1@thread.tacv2/enabledApps
70+
```
71+
72+
### Response
73+
74+
The following example shows the response.
75+
76+
>**Note:** The response object shown here might be shortened for readability.
77+
78+
<!-- {
79+
"blockType": "response",
80+
"truncated": true,
81+
"@odata.type": "Collection(microsoft.graph.teamsApp)"
82+
}
83+
-->
84+
85+
``` http
86+
HTTP/1.1 200 OK
87+
Content-Type: application/json
88+
89+
{
90+
"value": [
91+
{
92+
"@odata.type": "#microsoft.graph.teamsApp",
93+
"@odata.id": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/b1c5353a-7aca-41b3-830f-27d5218fe0e5",
94+
"id": "b1c5353a-7aca-41b3-830f-27d5218fe0e5",
95+
"externalId": "f31b1263-ba99-435a-a679-911d24850d7c",
96+
"displayName": "Sample App 1",
97+
"distributionMethod": "organization"
98+
},
99+
{
100+
"@odata.type": "#microsoft.graph.teamsApp",
101+
"@odata.id": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/c21ba739-90e0-462b-bc10-5c235ae55e99",
102+
"id": "c21ba739-90e0-462b-bc10-5c235ae55e99",
103+
"externalId": "c21ba739-90e0-462b-bc10-5c235ae55e88",
104+
"displayName": "Sample App 2",
105+
"distributionMethod": "organization"
106+
}
107+
]
108+
}
109+
```

‎api-reference/v1.0/api/channel-post-enabledapps.md‎

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
---
2+
title: "Add teamsApp"
3+
description: "Add a teamsApp that enables an app in the specified channel within a team."
4+
author: "devjha-ms"
5+
ms.date: 03/16/2026
6+
ms.localizationpriority: medium
7+
ms.subservice: "teams"
8+
doc_type: apiPageType
9+
---
10+
11+
# Add teamsApp
12+
13+
Namespace: microsoft.graph
14+
15+
Add a [teamsApp](../resources/teamsapp.md) that enables an [app](../resources/teamsapp.md) in the specified [channel](../resources/channel.md) within a [team](../resources/team.md). This operation is allowed only for channels with a **membershipType** value of `shared`.
16+
17+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
18+
19+
## Permissions
20+
21+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "channel_post_enabledapps"
26+
}
27+
-->
28+
29+
[!INCLUDE [permissions-table](../includes/permissions/channel-post-enabledapps-permissions.md)]
30+
31+
## HTTP request
32+
33+
<!-- {
34+
"blockType": "ignored"
35+
}
36+
-->
37+
38+
``` http
39+
POST /teams/{team-id}/channels/{channel-id}/enabledApps/$ref
40+
```
41+
42+
## Request headers
43+
44+
|Name|Description|
45+
|:---|:---|
46+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
47+
|Content-Type|application/json. Required.|
48+
49+
## Request body
50+
51+
In the request body, supply a JSON object that contains an **@odata.id** property with a reference by ID to a [teamsApp](../resources/teamsapp.md) object.
52+
53+
## Response
54+
55+
If successful, this method returns a `204 No Content` response code.
56+
57+
## Examples
58+
59+
### Request
60+
61+
The following example shows a request.
62+
63+
<!-- {
64+
"blockType": "request",
65+
"name": "create_channel_enabledapps",
66+
"sampleKeys": ["893075dd-2487-4122-925f-022c42e20265", "19:561fbdbbfca848a3a8df3ffe558b1c1@thread.tacv2", "b1c5353a-7aca-41b3-830f-27d5218fe0e5"]
67+
}
68+
-->
69+
70+
``` http
71+
POST https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a3a8df3ffe558b1c1@thread.tacv2/enabledApps/$ref
72+
Content-Type: application/json
73+
74+
{
75+
"@odata.id": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/b1c5353a-7aca-41b3-830f-27d5218fe0e5"
76+
}
77+
```
78+
79+
### Response
80+
81+
The following example shows the response.
82+
83+
<!-- {
84+
"blockType": "response",
85+
"truncated": true
86+
}
87+
-->
88+
89+
``` http
90+
HTTP/1.1 204 No Content
91+
```

0 commit comments

Comments
 (0)