Skip to content

Commit 6a16552

Browse files
JarbasHorstJarbasHorst
authored
Merge branch 'main' into 2025-01-15-manjaris-haiku-parameters
2 parents 03e8b18 + ebfda59 commit 6a16552

25 files changed

+449
-355
lines changed

‎api-reference/beta/api/security-ediscoverycase-list-tags.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -25,10 +25,6 @@ Choose the permission or permissions marked as least privileged for this API. Us
2525

2626
## HTTP request
2727

28-
<!-- {
29-
"blockType": "ignored"
30-
}
31-
-->
3228
``` http
3329
GET /security/cases/ediscoveryCases/{ediscoveryCaseId}/tags
3430
```
@@ -47,14 +43,15 @@ If successful, this method returns a `200 OK` response code and a collection of
4743
## Examples
4844

4945
### Request
50-
The following example shows a request.
46+
The following example shows a request that lists tags.
5147

52-
# [HTTP](#tab/http)
48+
# [HTTP](#tab/http)
5349
<!-- {
5450
"blockType": "request",
5551
"name": "list_ediscoveryreviewtag_and_properties"
5652
}
5753
-->
54+
5855
``` http
5956
GET https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/tags
6057
```

‎api-reference/beta/api/security-ediscoveryreviewtag-ashierarchy.md

Lines changed: 38 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -46,9 +46,9 @@ Don't supply a request body for this method.
4646
If successful, this function returns a `200 OK` response code and a [microsoft.graph.security.ediscoveryReviewTag](../resources/security-ediscoveryreviewtag.md) collection in the response body.
4747

4848
## Examples
49-
50-
### Request
51-
The following example shows a request.
49+
### Example 1: Retrieve child tags of a specific eDiscovery review tag
50+
#### Request
51+
The following example shows a request that retrieves child tags.
5252

5353
# [HTTP](#tab/http)
5454
<!-- {
@@ -94,7 +94,7 @@ GET https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-ceb
9494

9595
---
9696

97-
### Response
97+
#### Response
9898
The following example shows the response.
9999
>**Note:** The response object shown here might be shortened for readability.
100100
<!-- {
@@ -198,3 +198,37 @@ Content-Type: application/json
198198
}
199199
```
200200

201+
### Example 2: Retrieve child tags of a specific eDiscovery review tag
202+
#### Request
203+
The following example shows a request to retrieve child tags
204+
<!-- {
205+
"blockType": "request",
206+
"name": "ediscoveryreviewtagthis.childtags"
207+
}
208+
-->
209+
210+
``` http
211+
GET https://graph.microsoft.com/beta/security/cases/ediscoveryCases/b6f72954-c7d0-414c-ad50-00167216cb03/tags/318f79767abf4b8fab4d8e37b3174c5a/childTags
212+
```
213+
214+
#### Response
215+
The following example shows the response.
216+
<!-- {
217+
"blockType": "response",
218+
"truncated": true,
219+
"@odata.type": "Collection(microsoft.graph.security.ediscoveryReviewTag)"
220+
}
221+
-->
222+
``` http
223+
HTTP/1.1 200 OK
224+
Content-Type: application/json
225+
226+
{
227+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.security.ediscoveryReviewTag)",
228+
"@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET security/cases/ediscoveryCases('<guid>')/tags('<guid>')/childTags?$select=childSelectability",
229+
"value": []
230+
}
231+
```
232+
233+
234+

‎api-reference/beta/api/teamschannelplanner-list-plans.md

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
---
2+
title: "List plans"
3+
description: "Get a list of plannerPlan objects owned by a shared channel in Teams."
4+
ms.localizationpriority: medium
5+
author: "DanluCui"
6+
ms.subservice: "planner"
7+
doc_type: apiPageType
8+
ms.date: 01/29/2025
9+
---
10+
11+
# List plans
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get a list of [plannerPlan](../resources/plannerplan.md) objects owned by a shared [channel](../resources/channel.md) in Teams.
18+
19+
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
20+
21+
## Permissions
22+
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).
23+
24+
<!-- { "blockType": "permissions", "name": "teamschannelplanner_list_plans" } -->
25+
[!INCLUDE [permissions-table](../includes/permissions/teamschannelplanner-list-plans-permissions.md)]
26+
27+
## HTTP request
28+
<!-- { "blockType": "ignored" } -->
29+
```http
30+
GET /teams/{team-id}/channels/{channel-id}/planner/plans
31+
```
32+
33+
### Optional query parameters
34+
35+
This method doesn't support [OData query parameters](/graph/query-parameters) to customize the response.
36+
37+
## Request headers
38+
| Name |Description|
39+
|:----------|:----------|
40+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
41+
42+
## Request body
43+
Don't supply a request body for this method.
44+
45+
## Response
46+
47+
If successful, this method returns a `200 OK` response code and a collection of [plannerPlan](../resources/plannerplan.md) objects in the response body.
48+
49+
This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the `403` and `404` responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions).
50+
51+
## Examples
52+
53+
### Request
54+
55+
The following example shows a request.
56+
57+
<!-- {
58+
"blockType": "request",
59+
"name": "list_plans_owned_by_channel",
60+
"sampleKeys" : ["a738af50-90f1-472c-b3c3-a468f88ceaba", "19:yVS-hfmJ8w61Vu4oehlAr-y9G0eeyY11D8elrrDSvCU1@thread.tacv2"]
61+
}-->
62+
```http
63+
GET https://graph.microsoft.com/beta/teams/a738af50-90f1-472c-b3c3-a468f88ceaba/channels/19:yVS-hfmJ8w61Vu4oehlAr-y9G0eeyY11D8elrrDSvCU1@thread.tacv2/planner/plans
64+
```
65+
66+
### Response
67+
68+
The following example shows the response.
69+
70+
>**Note:** The response object shown here might be shortened for readability.
71+
<!-- {
72+
"blockType": "response",
73+
"truncated": true,
74+
"@odata.type": "Collection(microsoft.graph.plannerPlan)"
75+
} -->
76+
```http
77+
HTTP/1.1 200 OK
78+
Content-type: application/json
79+
80+
{
81+
"value": [
82+
{
83+
"@odata.etag": "W/\"JzEtUGxhbiAgQEBAQEBAQEBAQEBAQEBARCc=\"",
84+
"createdDateTime": "2025-01-14T18:03:25.8457422Z",
85+
"isArchived": false,
86+
"owner": "ba2b2488-cb8c-4dbc-882e-a9a8311bfee9",
87+
"title": "travel plan",
88+
"id": "TQZYwVBC4E6BUIg4nfSnfJUADdBY",
89+
"createdBy": {
90+
"application": {
91+
"id": "de8bc8b5-d9f9-48b1-a8ad-b748da725064"
92+
},
93+
"user": {
94+
"id": "ba2b2488-cb8c-4dbc-882e-a9a8311bfee9"
95+
}
96+
},
97+
"container": {
98+
"containerId": "a738af50-90f1-472c-b3c3-a468f88ceaba/channels/19:yVS-hfmJ8w61Vu4oehlAr-y9G0eeyY11D8elrrDSvCU1@thread.tacv2",
99+
"type": "teamsChannel",
100+
"url": "https://graph.microsoft.com/beta/teams/a738af50-90f1-472c-b3c3-a468f88ceaba/channels/19:yVS-hfmJ8w61Vu4oehlAr-y9G0eeyY11D8elrrDSvCU1@thread.tacv2"
101+
}
102+
}
103+
]
104+
}
105+
```
106+
107+
<!-- uuid: 3da1192e-9af9-47d4-b32c-1ba82ddabcd1
108+
2025-01-15 22:58:43 UTC -->
109+
<!--
110+
{
111+
"type": "#page.annotation",
112+
"description": "List plans",
113+
"keywords": "",
114+
"section": "documentation",
115+
"tocPath": "",
116+
"suppressions": [
117+
]
118+
}
119+
-->

‎api-reference/beta/includes/permissions/teamschannelplanner-list-plans-permissions.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
description: "Automatically generated file. DO NOT MODIFY"
3+
ms.topic: include
4+
ms.localizationpriority: medium
5+
---
6+
7+
|Permission type|Least privileged permissions|Higher privileged permissions|
8+
|:---|:---|:---|
9+
|Delegated (work or school account)|Tasks.Read|Tasks.ReadWrite|
10+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
11+
|Application|Tasks.Read.All|Tasks.ReadWrite.All|

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Represents the [authentication event listeners](authenticationeventlistener.md)
1919
## Properties
2020
|Property|Type|Description|
2121
|:---|:---|:---|
22-
|eventType|authenticationEventType|The type of authentication event that triggered the custom authentication extension request. The possible values are: `tokenIssuanceStart`, `pageRenderStart`, `unknownFutureValue`.|
22+
|eventType|authenticationEventType|The type of authentication event that triggered the custom authentication extension request. The possible values are: `tokenIssuanceStart`, `pageRenderStart`, `unknownFutureValue`, `attributeCollectionStart`, `attributeCollectionSubmit`, `emailOtpSend`. Use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `attributeCollectionStart`, `attributeCollectionSubmit`, `emailOtpSend`. |
2323
|executedListenerId|String|ID of the [authentication event listener](authenticationeventlistener.md) that was executed.|
2424
|handlerResult|[authenticationEventHandlerResult](../resources/authenticationeventhandlerresult.md)|The result from the listening client, such as an Azure Logic App and Azure Functions, of this authentication event.|
2525

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

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,8 @@ where files are shared, and where tabs are added.
5858
|[Unshare channel with team](../api/sharedwithchannelteaminfo-delete.md)|None|Unshare a channel with a team.|
5959
|[List allowed members](../api/sharedwithchannelteaminfo-list-allowedmembers.md)|[conversationMember](../resources/conversationmember.md) collection|Get the list of team members who have access to the shared channel.|
6060
|[Check user access](../api/channel-doesuserhaveaccess.md)|Boolean|Check whether a user has access to a shared channel or not.|
61+
| **Planner** | | |
62+
|[List plans](../api/teamschannelplanner-list-plans.md) |[plannerPlan](plannerplan.md) collection| Get a list of [plannerPlan](../resources/plannerplan.md) objects owned by a shared [channel](../resources/channel.md) in Teams.|
6163

6264
## Properties
6365

@@ -82,7 +84,7 @@ where files are shared, and where tabs are added.
8284
|:-------------------|:----------------------------------------------------------------------------------|
8385
| standard | Channel inherits the list of members of the parent team. |
8486
| private | Channel can have members that are a subset of all the members on the parent team. |
85-
| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. |
87+
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
8688
| shared | Members can be directly added to the channel without adding them to the team. |
8789

8890
### Instance attributes
@@ -101,17 +103,18 @@ For a POST request example, see [Request (create channel in migration state)](/m
101103

102104
| Relationship | Type |Description|
103105
|:---------------|:--------|:----------|
104-
|messages|[chatMessage](chatmessage.md) collection|A collection of all the messages in the channel. A navigation property. Nullable.|
105-
|tabs|[teamsTab](../resources/teamstab.md) collection|A collection of all the tabs in the channel. A navigation property.|
106-
|members|[conversationMember](conversationmember.md) collection|A collection of membership records associated with the channel.|
107106
|allMembers|[conversationMember](conversationmember.md) collection |A collection of membership records associated with the channel. It includes both direct and indirect members of shared channels.|
108107
|[filesFolder](../api/channel-get-filesfolder.md)|[driveItem](driveitem.md)|Metadata for the location where the channel's files are stored.|
108+
|members|[conversationMember](conversationmember.md) collection|A collection of membership records associated with the channel.|
109+
|messages|[chatMessage](chatmessage.md) collection|A collection of all the messages in the channel. Nullable.|
109110
|operations|[teamsAsyncOperation](teamsasyncoperation.md) collection| The async operations that ran or are running on this team. |
111+
|planner|[teamsChannelPlanner](teamschannelplanner.md) | Selective Planner services available to this channel. Currently, only shared channels are supported. Read-only. Nullable. |
110112
|sharedWithTeams|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) collection|A collection of teams with which a channel is shared.|
113+
|tabs|[teamsTab](../resources/teamstab.md) collection|A collection of all the tabs in the channel. |
111114

112115
## JSON representation
113116

114-
The following JSON representation shows the resource type
117+
The following JSON representation shows the resource type.
115118

116119
<!-- {
117120
"blockType": "resource",

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ None.
2626
|Property|Type|Description|
2727
|:---|:---|:---|
2828
| callerInfo | [emergencyCallerInfo](../resources/emergencycallerinfo.md)| The information of the emergency caller. |
29-
| callEventType | callEventType| The event type of the call. Possible values are: `callStarted`, `callEnded`, `unknownFutureValue`, `rosterUpdated`. 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): `rosterUpdated`.|
29+
| callEventType | callEventType| The event type of the call. Possible values are: `callStarted`, `callEnded`, `unknownFutureValue`, `rosterUpdated`. 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): `rosterUpdated`.|
3030
| emergencyNumberDialed | String | The emergency number dialed. |
3131
| eventDateTime | DateTimeOffset | The time of when event occurred. |
3232
| id | String | The entity ID. |

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

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
title: "teamsChannelPlanner resource type"
3+
description: "Provides access to Planner resources for a Teams shared channel."
4+
ms.localizationpriority: medium
5+
author: "DanluCui"
6+
ms.subservice: "planner"
7+
doc_type: resourcePageType
8+
ms.date: 01/15/2025
9+
---
10+
11+
# teamsChannelPlanner resource type
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Provides access to Planner resources for a Teams shared [channel](channel.md). This resource doesn't contain any usable properties.
18+
19+
Inherits from [entity](entity.md).
20+
21+
## Methods
22+
| Method | Return Type |Description|
23+
|:---------------|:--------|:----------|
24+
|[List plans](../api/teamschannelplanner-list-plans.md) |[plannerPlan](plannerplan.md) collection| Get a list of [plannerPlan](../resources/plannerplan.md) objects owned by a shared [channel](../resources/channel.md) in Teams.|
25+
26+
## Properties
27+
| Property | Type |Description|
28+
|:---------------|:--------|:----------|
29+
|id|String| The unique identifier for the **teamsChannelPlanner** object. Read-only. Inherited from [entity](entity.md).|
30+
31+
## Relationships
32+
| Relationship | Type |Description|
33+
|:---------------|:--------|:----------|
34+
|plans|[plannerPlan](plannerplan.md) collection| A collection of [plannerPlan](plannerplan.md) objects owned by the Teams channel. Currently, only shared channels are supported. Read-only. Nullable.|
35+
36+
## JSON representation
37+
38+
The following JSON representation shows the resource type.
39+
40+
<!-- {
41+
"blockType": "resource",
42+
"optionalProperties": [
43+
],
44+
"keyProperty": "id",
45+
"baseType":"microsoft.graph.entity",
46+
"@odata.type": "microsoft.graph.teamsChannelPlanner"
47+
}-->
48+
49+
```json
50+
{
51+
"id": "String (identifier)"
52+
}
53+
```
54+
55+
<!-- uuid: 3da1192e-9af9-47d4-b32c-1ba82ddabcd1
56+
2025-01-15 22:58:43 UTC -->
57+
<!--
58+
{
59+
"type": "#page.annotation",
60+
"description": "teamsChannelPlanner resource",
61+
"keywords": "",
62+
"section": "documentation",
63+
"tocPath": "",
64+
"suppressions": []
65+
}
66+
-->

‎api-reference/beta/toc/tasks-and-plans/toc.yml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,12 @@ items:
110110
href: ../../api/plannertaskdetails-get.md
111111
- name: Update task details
112112
href: ../../api/plannertaskdetails-update.md
113+
- name: Teams channel planner
114+
items:
115+
- name: Teams channel planner
116+
href: ../../resources/teamschannelplanner.md
117+
- name: List plans
118+
href: ../../api/teamschannelplanner-list-plans.md
113119
- name: Business scenarios (preview)
114120
items:
115121
- name: Overview

‎api-reference/beta/toc/teamwork-and-communications/toc.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -819,6 +819,10 @@ items:
819819
href: ../../api/sharedwithchannelteaminfo-list-allowedmembers.md
820820
- name: Check user access
821821
href: ../../api/channel-doesuserhaveaccess.md
822+
- name: Planner
823+
items:
824+
- name: List plans
825+
href: ../../api/teamschannelplanner-list-plans.md
822826
- name: Chat
823827
items:
824828
- name: Chat

0 commit comments

Comments
 (0)