Address PR review feedback and fix API Doctor validation

jsinghmokha · jsinghmokha · commit 889abdd33b83 · 2026-03-10T18:25:15.000-07:00
- Replace inline permission tables with include file references using blockType permissions
- Add permission include files for all 5 section management APIs
- Fix @odata.type syntax in list sections response
- Remove "currently" from OData query params text
- Remove sectionType and sectionSortType from enums.md (kept in resource topic)
- Move Sections (preview) under Messaging in TOC
diff --git a/api-reference/beta/api/teamworksection-delete.md b/api-reference/beta/api/teamworksection-delete.md
@@ -22,13 +22,8 @@ Delete a user-defined [section](../resources/teamworksection.md) from a user's [
 
 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).
 
-<!-- { "blockType": "ignored" } -->
-
-| Permission type | Least privileged permissions | Higher privileged permissions |
-|:----------------|:-----------------------------|:-----------------------------|
-| Delegated (work or school account) | TeamworkSection.ReadWrite | Not available. |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | TeamworkSection.ReadWrite.All | Not available. |
+<!-- { "blockType": "permissions", "name": "teamworksection_delete" } -->
+[!INCLUDE [permissions-table](../includes/permissions/teamworksection-delete-permissions.md)]
 
 ## HTTP request
 
diff --git a/api-reference/beta/api/teamworksection-get.md b/api-reference/beta/api/teamworksection-get.md
@@ -22,13 +22,8 @@ Read the properties of a [section](../resources/teamworksection.md) in a user's
 
 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).
 
-<!-- { "blockType": "ignored" } -->
-
-| Permission type | Least privileged permissions | Higher privileged permissions |
-|:----------------|:-----------------------------|:-----------------------------|
-| Delegated (work or school account) | TeamworkSection.Read | TeamworkSection.ReadWrite |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | TeamworkSection.Read.All | TeamworkSection.ReadWrite.All |
+<!-- { "blockType": "permissions", "name": "teamworksection_get" } -->
+[!INCLUDE [permissions-table](../includes/permissions/teamworksection-get-permissions.md)]
 
 ## HTTP request
 
@@ -39,7 +34,7 @@ GET /users/{user-id}/teamwork/sections/{teamworkSection-id}
 
 ## Optional query parameters
 
-This method doesn't currently support [OData query parameters](/graph/query-parameters) to customize the response.
+This method doesn't support [OData query parameters](/graph/query-parameters) to customize the response.
 
 ## Request headers
 
diff --git a/api-reference/beta/api/teamworksection-update.md b/api-reference/beta/api/teamworksection-update.md
@@ -22,13 +22,8 @@ Update the properties of a [section](../resources/teamworksection.md) in a user'
 
 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).
 
-<!-- { "blockType": "ignored" } -->
-
-| Permission type | Least privileged permissions | Higher privileged permissions |
-|:----------------|:-----------------------------|:-----------------------------|
-| Delegated (work or school account) | TeamworkSection.ReadWrite | Not available. |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | TeamworkSection.ReadWrite.All | Not available. |
+<!-- { "blockType": "permissions", "name": "teamworksection_update" } -->
+[!INCLUDE [permissions-table](../includes/permissions/teamworksection-update-permissions.md)]
 
 ## HTTP request
 
diff --git a/api-reference/beta/api/userteamwork-list-sections.md b/api-reference/beta/api/userteamwork-list-sections.md
@@ -22,13 +22,8 @@ Get the list of [sections](../resources/teamworksection.md) in a user's [teamwor
 
 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).
 
-<!-- { "blockType": "ignored" } -->
-
-| Permission type | Least privileged permissions | Higher privileged permissions |
-|:----------------|:-----------------------------|:-----------------------------|
-| Delegated (work or school account) | TeamworkSection.Read | TeamworkSection.ReadWrite |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | TeamworkSection.Read.All | TeamworkSection.ReadWrite.All |
+<!-- { "blockType": "permissions", "name": "userteamwork_list_sections" } -->
+[!INCLUDE [permissions-table](../includes/permissions/userteamwork-list-sections-permissions.md)]
 
 ## HTTP request
 
@@ -39,7 +34,7 @@ GET /users/{user-id}/teamwork/sections
 
 ## Optional query parameters
 
-This method doesn't currently support [OData query parameters](/graph/query-parameters) to customize the response.
+This method doesn't support [OData query parameters](/graph/query-parameters) to customize the response.
 
 ## Request headers
 
@@ -79,7 +74,7 @@ The following example shows the response.
 <!-- {
   "blockType": "response",
   "truncated": true,
-  "@odata.type": "Collection(microsoft.graph.teamworkSection")
+  "@odata.type": "Collection(microsoft.graph.teamworkSection)"
 }-->
 ```http
 HTTP/1.1 200 OK
diff --git a/api-reference/beta/api/userteamwork-post-sections.md b/api-reference/beta/api/userteamwork-post-sections.md
@@ -22,13 +22,8 @@ Create a new [section](../resources/teamworksection.md) in a user's [teamwork](.
 
 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).
 
-<!-- { "blockType": "ignored" } -->
-
-| Permission type | Least privileged permissions | Higher privileged permissions |
-|:----------------|:-----------------------------|:-----------------------------|
-| Delegated (work or school account) | TeamworkSection.ReadWrite | Not available. |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | TeamworkSection.ReadWrite.All | Not available. |
+<!-- { "blockType": "permissions", "name": "userteamwork_post_sections" } -->
+[!INCLUDE [permissions-table](../includes/permissions/userteamwork-post-sections-permissions.md)]
 
 ## HTTP request
 
diff --git a/api-reference/beta/includes/permissions/teamworksection-delete-permissions.md b/api-reference/beta/includes/permissions/teamworksection-delete-permissions.md
@@ -0,0 +1,5 @@
+|Permission type|Least privileged permissions|Higher privileged permissions|
+|:---|:---|:---|
+|Delegated (work or school account)|TeamworkSection.ReadWrite|Not available.|
+|Delegated (personal Microsoft account)|Not supported.|Not supported.|
+|Application|TeamworkSection.ReadWrite.All|Not available.|
diff --git a/api-reference/beta/includes/permissions/teamworksection-get-permissions.md b/api-reference/beta/includes/permissions/teamworksection-get-permissions.md
@@ -0,0 +1,5 @@
+|Permission type|Least privileged permissions|Higher privileged permissions|
+|:---|:---|:---|
+|Delegated (work or school account)|TeamworkSection.Read|TeamworkSection.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|Not supported.|
+|Application|TeamworkSection.Read.All|TeamworkSection.ReadWrite.All|
diff --git a/api-reference/beta/includes/permissions/teamworksection-update-permissions.md b/api-reference/beta/includes/permissions/teamworksection-update-permissions.md
@@ -0,0 +1,5 @@
+|Permission type|Least privileged permissions|Higher privileged permissions|
+|:---|:---|:---|
+|Delegated (work or school account)|TeamworkSection.ReadWrite|Not available.|
+|Delegated (personal Microsoft account)|Not supported.|Not supported.|
+|Application|TeamworkSection.ReadWrite.All|Not available.|
diff --git a/api-reference/beta/includes/permissions/userteamwork-list-sections-permissions.md b/api-reference/beta/includes/permissions/userteamwork-list-sections-permissions.md
@@ -0,0 +1,5 @@
+|Permission type|Least privileged permissions|Higher privileged permissions|
+|:---|:---|:---|
+|Delegated (work or school account)|TeamworkSection.Read|TeamworkSection.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|Not supported.|
+|Application|TeamworkSection.Read.All|TeamworkSection.ReadWrite.All|
diff --git a/api-reference/beta/includes/permissions/userteamwork-post-sections-permissions.md b/api-reference/beta/includes/permissions/userteamwork-post-sections-permissions.md
@@ -0,0 +1,5 @@
+|Permission type|Least privileged permissions|Higher privileged permissions|
+|:---|:---|:---|
+|Delegated (work or school account)|TeamworkSection.ReadWrite|Not available.|
+|Delegated (personal Microsoft account)|Not supported.|Not supported.|
+|Application|TeamworkSection.ReadWrite.All|Not available.|
diff --git a/api-reference/beta/resources/enums.md b/api-reference/beta/resources/enums.md
@@ -3897,24 +3897,6 @@ Possible values for user account types (group membership), per Windows definitio
 | dark |
 | unknownFutureValue |
 
-### sectionSortType values
-
-| Member |
-| ------------------ |
-| mostRecent |
-| unreadThenMostRecent |
-| nameAlphabetical |
-| userDefinedCustomOrder |
-| unknownFutureValue |
-
-### sectionType values
-
-| Member |
-| ------------------ |
-| userDefined |
-| systemDefined |
-| unknownFutureValue |
-
 ### serviceHealthClassificationType values
 
 | Member |
diff --git a/api-reference/beta/toc/toc.mapping.json b/api-reference/beta/toc/toc.mapping.json
@@ -3569,15 +3569,17 @@
           ],
           "complexTypes": [
             "forwardToChatResult"
-          ]
-        },
-        {
-          "name": "Sections (preview)",
-          "resources": [
-            "teamworkSection"
           ],
-          "complexTypes": [
-            "sectionDisplayIcon"
+          "childNodes": [
+            {
+              "name": "Sections (preview)",
+              "resources": [
+                "teamworkSection"
+              ],
+              "complexTypes": [
+                "sectionDisplayIcon"
+              ]
+            }
           ]
         },
         {
