Skip to content

Commit 22d9f7b

Browse files
DanipocketDanipocket
authored
Merge pull request #28397 from microsoftgraph/user/jsinghmokha/add-section-management-apis-beta
Add section management API docs for beta
2 parents d0051c0 + 7aba5f6 commit 22d9f7b

28 files changed

Lines changed: 1729 additions & 5 deletions

‎api-reference/beta/api/teamworksection-delete.md‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
---
2+
title: "Delete teamworkSection"
3+
description: "Delete a user-defined section from a user's teamwork."
4+
author: "jsinghmokha"
5+
ms.localizationpriority: medium
6+
ms.subservice: "teams"
7+
doc_type: apiPageType
8+
ms.date: 03/08/2026
9+
---
10+
11+
# Delete teamworkSection
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Delete a user-defined [section](../resources/teamworksection.md) from a user's [teamwork](../resources/userteamwork.md). System-defined sections can't be deleted.
18+
19+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
20+
21+
## Permissions
22+
23+
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).
24+
25+
<!-- { "blockType": "permissions", "name": "teamworksection_delete" } -->
26+
[!INCLUDE [permissions-table](../includes/permissions/teamworksection-delete-permissions.md)]
27+
28+
## HTTP request
29+
30+
<!-- { "blockType": "ignored" } -->
31+
```http
32+
DELETE /users/{user-id}/teamwork/sections/{teamworkSection-id}
33+
```
34+
35+
## Request headers
36+
37+
| Header | Value |
38+
|:-------|:------|
39+
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
40+
| If-Match | The value of the **@microsoft.graph.sectionsVersion** annotation returned when you [list sections](userteamwork-list-sections.md), or the **@odata.etag** value from any previously retrieved [section](../resources/teamworksection.md). Required for optimistic concurrency control. |
41+
42+
## Request body
43+
44+
Don't supply a request body for this method.
45+
46+
## Response
47+
48+
If successful, this method returns a `204 No Content` response code. It doesn't return anything in the response body.
49+
50+
The following errors are possible.
51+
52+
| Response code | Message |
53+
|:---|:---|
54+
| `403 Forbidden` | This section is system-generated and cannot be modified. System-defined sections can't be deleted. |
55+
| `404 Not Found` | The specified section was not found. |
56+
| `412 Precondition Failed` | The `If-Match` header value doesn't match the current section hierarchy version. [List sections](userteamwork-list-sections.md) again to retrieve the current **@microsoft.graph.sectionsVersion** annotation and retry. |
57+
| `428 Precondition Required` | The `If-Match` header is required for this operation. |
58+
59+
## Examples
60+
61+
### Request
62+
63+
The following example shows a request.
64+
65+
<!-- {
66+
"blockType": "request",
67+
"name": "delete_teamworksection",
68+
"sampleKeys": ["10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f", "a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
69+
}-->
70+
```http
71+
DELETE https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890
72+
If-Match: "1742515200"
73+
```
74+
75+
### Response
76+
77+
The following example shows the response.
78+
79+
<!-- {
80+
"blockType": "response",
81+
"truncated": true
82+
}-->
83+
```http
84+
HTTP/1.1 204 No Content
85+
```
86+
87+
<!-- uuid: f6a7b890-1234-5678-9abc-def012345678
88+
2026-03-08 00:00:00 UTC -->
89+
<!--
90+
{
91+
"type": "#page.annotation",
92+
"description": "Delete teamworkSection",
93+
"keywords": "",
94+
"section": "documentation",
95+
"tocPath": ""
96+
}
97+
-->

‎api-reference/beta/api/teamworksection-get.md‎

Lines changed: 115 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,115 @@
1+
---
2+
title: "Get teamworkSection"
3+
description: "Read the properties of a section in a user's teamwork."
4+
author: "jsinghmokha"
5+
ms.localizationpriority: medium
6+
ms.subservice: "teams"
7+
doc_type: apiPageType
8+
ms.date: 03/08/2026
9+
---
10+
11+
# Get teamworkSection
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Read the properties of a [section](../resources/teamworksection.md) in a user's [teamwork](../resources/userteamwork.md).
18+
19+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
20+
21+
## Permissions
22+
23+
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).
24+
25+
<!-- { "blockType": "permissions", "name": "teamworksection_get" } -->
26+
[!INCLUDE [permissions-table](../includes/permissions/teamworksection-get-permissions.md)]
27+
28+
## HTTP request
29+
30+
<!-- { "blockType": "ignored" } -->
31+
```http
32+
GET /users/{user-id}/teamwork/sections/{teamworkSection-id}
33+
```
34+
35+
## Optional query parameters
36+
37+
This method doesn't support [OData query parameters](/graph/query-parameters) to customize the response.
38+
39+
## Request headers
40+
41+
| Header | Value |
42+
|:-------|:------|
43+
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
44+
| If-None-Match | The value of the **@microsoft.graph.sectionsVersion** annotation returned when you [list sections](userteamwork-list-sections.md), or the **@odata.etag** value from any previously retrieved [section](../resources/teamworksection.md). If the section hierarchy didn't change, this header returns a `304 Not Modified` response code. Optional. |
45+
46+
## Request body
47+
48+
Don't supply a request body for this method.
49+
50+
## Response
51+
52+
If successful, this method returns a `200 OK` response code and a [teamworkSection](../resources/teamworksection.md) object in the response body. If the `If-None-Match` header is provided and the resource didn't change, this method returns a `304 Not Modified` response.
53+
54+
## Examples
55+
56+
### Request
57+
58+
The following example shows a request.
59+
60+
<!-- {
61+
"blockType": "request",
62+
"name": "get_teamworksection",
63+
"sampleKeys": ["10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f", "a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
64+
}-->
65+
```msgraph-interactive
66+
GET https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890
67+
```
68+
69+
### Response
70+
71+
The following example shows the response.
72+
73+
>**Note:** The response object shown here might be shortened for readability.
74+
75+
<!-- {
76+
"blockType": "response",
77+
"truncated": true,
78+
"@odata.type": "microsoft.graph.teamworkSection"
79+
}-->
80+
```http
81+
HTTP/1.1 200 OK
82+
Content-type: application/json
83+
ETag: "1742515200"
84+
85+
{
86+
"@odata.type": "#microsoft.graph.teamworkSection",
87+
"@odata.etag": "\"1742515200\"",
88+
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
89+
"displayName": "Favorites",
90+
"displayIcon": {
91+
"iconType": "⭐",
92+
"displayName": "Star",
93+
"contentUrl": null,
94+
"skinTone": null
95+
},
96+
"sectionType": "userDefined",
97+
"sortType": "mostRecent",
98+
"isExpanded": true,
99+
"isHierarchicalViewEnabled": false,
100+
"createdDateTime": "2025-01-15T10:30:00Z",
101+
"lastModifiedDateTime": "2025-03-01T14:22:00Z"
102+
}
103+
```
104+
105+
<!-- uuid: d4e5f6a7-b890-1234-5678-9abcdef01234
106+
2026-03-08 00:00:00 UTC -->
107+
<!--
108+
{
109+
"type": "#page.annotation",
110+
"description": "Get teamworkSection",
111+
"keywords": "",
112+
"section": "documentation",
113+
"tocPath": ""
114+
}
115+
-->

‎api-reference/beta/api/teamworksection-list-items.md‎

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,120 @@
1+
---
2+
title: "List items"
3+
description: "Get the list of items in a section of a user's teamwork."
4+
author: "jsinghmokha"
5+
ms.localizationpriority: medium
6+
ms.subservice: "teams"
7+
doc_type: apiPageType
8+
ms.date: 03/08/2026
9+
---
10+
11+
# List items
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get the list of [items](../resources/teamworksectionitem.md) in a [section](../resources/teamworksection.md) of a user's [teamwork](../resources/userteamwork.md).
18+
19+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
20+
21+
## Permissions
22+
23+
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).
24+
25+
<!-- { "blockType": "permissions", "name": "teamworksection_list_items" } -->
26+
[!INCLUDE [permissions-table](../includes/permissions/teamworksection-list-items-permissions.md)]
27+
28+
## HTTP request
29+
30+
<!-- { "blockType": "ignored" } -->
31+
```http
32+
GET /users/{user-id}/teamwork/sections/{teamworkSection-id}/items
33+
```
34+
35+
## Optional query parameters
36+
37+
This method doesn't support [OData query parameters](/graph/query-parameters) to customize the response.
38+
39+
## Request headers
40+
41+
| Header | Value |
42+
|:-------|:------|
43+
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
44+
45+
## Request body
46+
47+
Don't supply a request body for this method.
48+
49+
## Response
50+
51+
If successful, this method returns a `200 OK` response code and a collection of [teamworkSectionItem](../resources/teamworksectionitem.md) objects in the response body.
52+
53+
## Examples
54+
55+
### Request
56+
57+
The following example shows a request.
58+
59+
<!-- {
60+
"blockType": "request",
61+
"name": "list_teamworksectionitems",
62+
"sampleKeys": ["10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f", "a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
63+
}-->
64+
```msgraph-interactive
65+
GET https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items
66+
```
67+
68+
### Response
69+
70+
The following example shows the response.
71+
72+
>**Note:** The response object shown here might be shortened for readability.
73+
74+
<!-- {
75+
"blockType": "response",
76+
"truncated": true,
77+
"@odata.type": "Collection(microsoft.graph.teamworkSectionItem)"
78+
}-->
79+
```http
80+
HTTP/1.1 200 OK
81+
Content-type: application/json
82+
83+
{
84+
"value": [
85+
{
86+
"@odata.type": "#microsoft.graph.teamworkSectionItem",
87+
"id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2",
88+
"itemType": "chat",
89+
"createdDateTime": "2025-02-10T09:15:00Z",
90+
"lastModifiedDateTime": "2025-03-05T11:30:00Z"
91+
},
92+
{
93+
"@odata.type": "#microsoft.graph.teamworkSectionItem",
94+
"id": "19:e6f7a8b9-0123-4567-89ab-cdef01234567@thread.tacv2",
95+
"itemType": "channel",
96+
"createdDateTime": "2025-01-20T14:00:00Z",
97+
"lastModifiedDateTime": "2025-03-01T08:45:00Z"
98+
},
99+
{
100+
"@odata.type": "#microsoft.graph.teamworkSectionItem",
101+
"id": "19:meeting_ZmY3NTg2ODEtYTFiNi00OTI4LWFmZTctODRhMTI1NjRkNWRm@thread.v2",
102+
"itemType": "meeting",
103+
"createdDateTime": "2025-03-01T16:00:00Z",
104+
"lastModifiedDateTime": "2025-03-01T16:00:00Z"
105+
}
106+
]
107+
}
108+
```
109+
110+
<!-- uuid: c4d5e6f7-a8b9-0123-cdef-345678901234
111+
2026-03-08 00:00:00 UTC -->
112+
<!--
113+
{
114+
"type": "#page.annotation",
115+
"description": "List teamworkSectionItems",
116+
"keywords": "",
117+
"section": "documentation",
118+
"tocPath": ""
119+
}
120+
-->

0 commit comments

Comments
 (0)