Skip to content

Commit dd60f96

Browse files
jsinghmokhaclaude
andcommitted
Clarify system-defined vs user-defined section behavior in section item APIs
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 2062c23 commit dd60f96

3 files changed

Lines changed: 4 additions & 4 deletions

File tree

api-reference/beta/api/teamworksection-post-items.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

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.
17+
Add an [item](../resources/teamworksectionitem.md), such as a chat, channel, meeting, or community, to a user-defined [section](../resources/teamworksection.md) in a user's [teamwork](../resources/userteamwork.md). Each item can belong to only one section at a time. You can only add items that are currently in a system-defined section. If the item is already in another user-defined section, use the [move](teamworksectionitem-move.md) action to relocate it.
1818

1919
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2020

@@ -62,7 +62,7 @@ This method can also return the following errors.
6262
| Scenario | HTTP code | Error code | Message |
6363
|:---------|:----------|:-----------|:--------|
6464
| Item already exists in this section | `409 Conflict` | `conflict` | This item is already in this section. |
65-
| 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. |
65+
| Item already exists in another user-defined section | `409 Conflict` | `conflict` | This item is already associated with another section. Use the [move](teamworksectionitem-move.md) API to relocate it. |
6666
| Maximum items per section reached | `400 Bad Request` | `badRequest` | The maximum number of items in this section is reached. |
6767
| Invalid item ID | `400 Bad Request` | `badRequest` | The specified item ID isn't valid. Provide a valid chat, channel, meeting, or community ID. |
6868
| ETag version mismatch | `412 Precondition Failed` | `preconditionFailed` | The resource was modified after it was last read. Read the latest version and retry. |

api-reference/beta/api/teamworksectionitem-delete.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

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.
17+
Remove an [item](../resources/teamworksectionitem.md) from a user-defined [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 user-defined section. The item is automatically moved back to its default system-defined section.
1818

1919
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2020

api-reference/beta/api/teamworksectionitem-move.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

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.
17+
Move an [item](../resources/teamworksectionitem.md) from one user-defined [section](../resources/teamworksection.md) to another user-defined section 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. Use this action instead of [add](teamworksection-post-items.md) when the item is already in a user-defined section.
1818

1919
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2020

0 commit comments

Comments
 (0)