You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Address PR review feedback for teamworkSectionItem API docs
- Rename teamworksection-delete-items to teamworksectionitem-delete per file naming conventions
- Fix titles: List items, Add teamworkSectionItem, Remove teamworkSectionItem
- Align description in line 3 and line 17 across all API topics
- Fix If-Match header to reference teamworkSectionItem instead of teamworkSection
- Add move API link in error table for post-items
- Avoid gerund in move response description
- Update items relationship description in teamworksection.md
- Remove sectionItemType from enums.md (Option 2: kept in resource topic)
- Update what's new to mention teamworkSectionItem APIs
- Add section management row to teams-api-overview.md
Add an [item](../resources/teamworksectionitem.md) such as a chat, channel, meeting, or community to a [section](../resources/teamworksection.md) in a user's [teamwork](../resources/userteamwork.md). Each item can belong to only one section at a time. If the item is already associated with another section, use the [move](teamworksectionitem-move.md) action instead.
17
+
Add an [item](../resources/teamworksectionitem.md), such as a chat, channel, meeting, or community, to a [section](../resources/teamworksection.md) in a user's [teamwork](../resources/userteamwork.md). Each item can belong to only one section at a time. If the item is already associated with another section, use the [move](teamworksectionitem-move.md) action instead.
@@ -38,7 +38,7 @@ POST /users/{user-id}/teamwork/sections/{teamworkSection-id}/items
38
38
|:-------|:------|
39
39
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
40
40
| Content-Type | application/json. Required. |
41
-
| If-Match | The ETag value of a previously retrieved **teamworkSection**. Required for optimistic concurrency control. |
41
+
| If-Match | The ETag value of a previously retrieved **teamworkSectionItem**. Required for optimistic concurrency control. |
42
42
43
43
## Request body
44
44
@@ -59,7 +59,7 @@ The following errors can occur:
59
59
| Scenario | HTTP code | Error code | Message |
60
60
|:---------|:----------|:-----------|:--------|
61
61
| Item already exists in this section |`409 Conflict`|`conflict`| This item is already in this section. |
62
-
| Item already exists in another section |`409 Conflict`|`conflict`| This item is already associated with another section. Use the move API to relocate it. |
62
+
| Item already exists in another section |`409 Conflict`|`conflict`| This item is already associated with another section. Use the [move](teamworksectionitem-move.md) API to relocate it. |
63
63
| Maximum items per section reached |`400 Bad Request`|`badRequest`| The maximum number of items in this section has been reached. |
64
64
| Invalid item ID |`400 Bad Request`|`badRequest`| The specified item ID is not valid. Provide a valid chat, channel, meeting, or community ID. |
65
65
| ETag version mismatch |`412 Precondition Failed`|`preconditionFailed`| The resource has been modified since it was last read. Read the latest version and retry. |
Copy file name to clipboardExpand all lines: api-reference/beta/api/teamworksectionitem-delete.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,29 +1,29 @@
1
1
---
2
-
title: "Remove item from section"
3
-
description: "Remove an item from a section in a user's teamwork."
2
+
title: "Remove teamworkSectionItem"
3
+
description: "Remove an item from a section in a user's teamwork. This API doesn't delete the underlying chat, channel, meeting, or community; it only removes the item from the section."
Remove an [item](../resources/teamworksectionitem.md) from a [section](../resources/teamworksection.md) in a user's [teamwork](../resources/userteamwork.md). This doesn't delete the underlying chat, channel, meeting, or community; it only removes the item from the section.
17
+
Remove an [item](../resources/teamworksectionitem.md) from a [section](../resources/teamworksection.md) in a user's [teamwork](../resources/userteamwork.md). This API doesn't delete the underlying chat, channel, meeting, or community; it only removes the item from the section.
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).
Copy file name to clipboardExpand all lines: api-reference/beta/api/teamworksectionitem-move.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: "teamworkSectionItem: move"
3
-
description: "Move an item from one section to another in a user's teamwork."
3
+
description: "Move an item from one section to another in a user's teamwork. Each item can belong to only one section at a time. This action removes the item from its current section and adds it to the target section."
Move a [teamworkSectionItem](../resources/teamworksectionitem.md) from one [section](../resources/teamworksection.md) to another in a user's [teamwork](../resources/userteamwork.md). Each item can belong to only one section at a time. This action removes the item from its current section and adds it to the target section.
17
+
Move an [item](../resources/teamworksectionitem.md) from one [section](../resources/teamworksection.md) to another in a user's [teamwork](../resources/userteamwork.md). Each item can belong to only one section at a time. This action removes the item from its current section and adds it to the target section.
@@ -38,7 +38,7 @@ POST /users/{user-id}/teamwork/sections/{teamworkSection-id}/items/{teamworkSect
38
38
|:-------|:------|
39
39
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
40
40
| Content-Type | application/json. Required. |
41
-
| If-Match | The ETag value of a previously retrieved **teamworkSection**. Required for optimistic concurrency control. |
41
+
| If-Match | The ETag value of a previously retrieved **teamworkSectionItem**. Required for optimistic concurrency control. |
42
42
43
43
## Request body
44
44
@@ -52,7 +52,7 @@ The following table lists the parameters that are required when you call this ac
52
52
53
53
## Response
54
54
55
-
If successful, this action returns a `200 OK` response code and a [teamworkSectionItem](../resources/teamworksectionitem.md) in the response body representing the item in the target section.
55
+
If successful, this action returns a `200 OK` response code and a [teamworkSectionItem](../resources/teamworksectionitem.md) in the response body that represents the item in the target section.
Copy file name to clipboardExpand all lines: api-reference/beta/resources/teams-api-overview.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,6 +29,7 @@ The following table lists common use cases for Microsoft Teams APIs in Microsoft
29
29
| Create and retrieve online meetings or check users presence and activity |[onlineMeeting](../resources/onlinemeeting.md), [presence](../resources/presence.md)|[create onlineMeeting](../api/application-post-onlinemeetings.md), [meetingAttendanceReport](../resources/meetingattendancereport.md)|
30
30
| Create and manage workforce integration with shifts, schedules, time cards, or time off in your organization |[workforceIntegration](../resources/workforceintegration.md), [schedule](../resources/schedule.md), [shift](../resources/shift.md), [timeOff](../resources/timeoff.md), [timeOffReason](../resources/timeoffreason.md)|[create workforceIntegration](../api/workforceintegration-post.md), [create schedule](../api/schedule-post-schedulinggroups.md), [create shift](../api/schedule-post-shifts.md), [create timeOff](../api/schedule-post-timesoff.md)|
31
31
| Use the employee learning API to integrate with Viva Learning |[employee learning](../resources/viva-learning-api-overview.md), [learningProvider](../resources/learningprovider.md), [learningContent](../resources/learningcontent.md)|[list learningProviders](../api/employeeexperience-list-learningproviders.md), [list learningContents](../api/learningprovider-list-learningcontents.md)|
32
+
| Organize chats, channels, and meetings into custom or system-defined sections in a user's chat list |[teamworkSection](../resources/teamworksection.md), [teamworkSectionItem](../resources/teamworksectionitem.md)|[list sections](../api/userteamwork-list-sections.md), [create section](../api/userteamwork-post-sections.md), [add item](../api/teamworksection-post-items.md), [move item](../api/teamworksectionitem-move.md)|
Copy file name to clipboardExpand all lines: api-reference/beta/resources/teamworksection.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,7 @@ Represents a section in a user's Microsoft Teams chat list that organizes chats,
27
27
|[Delete](../api/teamworksection-delete.md)| None | Delete a user-defined [section](../resources/teamworksection.md) from a user's [teamwork](../resources/userteamwork.md). |
28
28
|[List items](../api/teamworksection-list-items.md)|[teamworkSectionItem](teamworksectionitem.md) collection | Get the list of [items](../resources/teamworksectionitem.md) in a [section](../resources/teamworksection.md). |
29
29
|[Add item](../api/teamworksection-post-items.md)|[teamworkSectionItem](teamworksectionitem.md)| Add an [item](../resources/teamworksectionitem.md) to a [section](../resources/teamworksection.md). |
30
-
|[Remove item](../api/teamworksection-delete-items.md)| None | Remove an [item](../resources/teamworksectionitem.md) from a [section](../resources/teamworksection.md). |
30
+
|[Remove item](../api/teamworksectionitem-delete.md)| None | Remove an [item](../resources/teamworksectionitem.md) from a [section](../resources/teamworksection.md). |
31
31
|[Move item](../api/teamworksectionitem-move.md)|[teamworkSectionItem](teamworksectionitem.md)| Move an [item](../resources/teamworksectionitem.md) from one section to another. |
32
32
33
33
## Properties
@@ -69,7 +69,7 @@ Represents a section in a user's Microsoft Teams chat list that organizes chats,
69
69
70
70
| Relationship | Type | Description |
71
71
|:-------------|:-----|:------------|
72
-
| items |[teamworkSectionItem](teamworksectionitem.md) collection | The items (chats, channels, meetings, communities) organized within the section. |
72
+
| items |[teamworkSectionItem](teamworksectionitem.md) collection | The items (chats, channels, meetings, or communities) organized within the section. |
Copy file name to clipboardExpand all lines: api-reference/beta/resources/teamworksectionitem.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: "teamworkSectionItem resource type"
3
-
description: "Represents an item such as a chat, channel, meeting, or community that is organized within a section in a user's Microsoft Teams chat list."
3
+
description: "Represents an item, such as a chat, channel, meeting, or community, that is organized within a section in a user's Microsoft Teams chat list."
Represents an item such as a chat, channel, meeting, or community that is organized within a [section](teamworksection.md) in a user's Microsoft Teams chat list. Each item belongs to exactly one section at a time. Use the [move](../api/teamworksectionitem-move.md) action to relocate an item to a different section.
17
+
Represents an item, such as a chat, channel, meeting, or community, that is organized within a [section](teamworksection.md) in a user's Microsoft Teams chat list. Each item belongs to exactly one section at a time. Use the [move](../api/teamworksectionitem-move.md) action to relocate an item to a different section.
18
18
19
19
## Methods
20
20
21
21
| Method | Return type | Description |
22
22
|:-------|:------------|:------------|
23
23
|[List](../api/teamworksection-list-items.md)|[teamworkSectionItem](teamworksectionitem.md) collection | Get the list of items in a [section](../resources/teamworksection.md). |
24
24
|[Add](../api/teamworksection-post-items.md)|[teamworkSectionItem](teamworksectionitem.md)| Add an item to a [section](../resources/teamworksection.md). |
25
-
|[Remove](../api/teamworksection-delete-items.md)| None | Remove an item from a [section](../resources/teamworksection.md). |
25
+
|[Remove](../api/teamworksectionitem-delete.md)| None | Remove an item from a [section](../resources/teamworksection.md). |
26
26
|[Move](../api/teamworksectionitem-move.md)|[teamworkSectionItem](teamworksectionitem.md)| Move an item from one section to another. |
Copy file name to clipboardExpand all lines: concepts/whats-new-overview.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -50,7 +50,7 @@ Added the [targetAgentIdentitySponsorsOrOwners](/graph/api/resources/targetagent
50
50
51
51
### Teamwork and communications | Sections
52
52
53
-
Organize chats, channels, and meetings into custom sections in a user's Microsoft Teams chat list using the new [teamworkSection](/graph/api/resources/teamworksection?view=graph-rest-beta&preserve-view=true) resource. Use the section management APIs to [list](/graph/api/userteamwork-list-sections?view=graph-rest-beta&preserve-view=true), [create](/graph/api/userteamwork-post-sections?view=graph-rest-beta&preserve-view=true), [get](/graph/api/teamworksection-get?view=graph-rest-beta&preserve-view=true), [update](/graph/api/teamworksection-update?view=graph-rest-beta&preserve-view=true), and [delete](/graph/api/teamworksection-delete?view=graph-rest-beta&preserve-view=true) sections.
53
+
Organize chats, channels, and meetings into custom sections in a user's Microsoft Teams chat list using the new [teamworkSection](/graph/api/resources/teamworksection?view=graph-rest-beta&preserve-view=true) and [teamworkSectionItem](/graph/api/resources/teamworksectionitem?view=graph-rest-beta&preserve-view=true) resources. Use the section management APIs to [list](/graph/api/userteamwork-list-sections?view=graph-rest-beta&preserve-view=true), [create](/graph/api/userteamwork-post-sections?view=graph-rest-beta&preserve-view=true), [get](/graph/api/teamworksection-get?view=graph-rest-beta&preserve-view=true), [update](/graph/api/teamworksection-update?view=graph-rest-beta&preserve-view=true), and [delete](/graph/api/teamworksection-delete?view=graph-rest-beta&preserve-view=true) sections, and [add](/graph/api/teamworksection-post-items?view=graph-rest-beta&preserve-view=true), [remove](/graph/api/teamworksectionitem-delete?view=graph-rest-beta&preserve-view=true), and [move](/graph/api/teamworksectionitem-move?view=graph-rest-beta&preserve-view=true) items within sections.
0 commit comments