Merge pull request #28645 from microsoftgraph/users/sumanac/changelogfornextlink

Document @odata.nextLink pagination support for Teams channel list APIs

Author: Danipocket

api-reference/beta/api/channel-list.md

@@ -61,7 +61,9 @@ Don't supply a request body for this method.
 
 ## Response
 
-If successful, this method returns a `200 OK` response code and collection of [Channel](../resources/channel.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [channel](../resources/channel.md) objects in the response body. 
+
+When the result set spans multiple pages, the response includes an **@odata.nextLink** property with a URL for retrieving the next page of results. For details about how to page through results, see [Paging Microsoft Graph data in your app](/graph/paging).
 
 ## Examples
 

api-reference/beta/api/team-list-allchannels.md

@@ -54,7 +54,9 @@ Don't supply a request body for this method.
 
 ## Response
 
-If successful, this method returns a `200 OK` response code and a collection of [channel](../resources/channel.md) objects in the response body. The response also includes the **@odata.id** property, which can be used to access the channel and run other operations on the [channel](../resources/channel.md) object.
+If successful, this method returns a `200 OK` response code and a collection of [channel](../resources/channel.md) objects in the response body. The response also includes the **@odata.id** property, which can be used to access the channel and run other operations on the [channel](../resources/channel.md) object. 
+
+When the result set spans multiple pages, the response includes an **@odata.nextLink** property with a URL for retrieving the next page of results. For details about how to page through results, see [Paging Microsoft Graph data in your app](/graph/paging).
 
 > [!Note]
 > Currently, invoking the URL returned from the **@odata.id** property fails for cross-tenant shared channels. You can solve this issue if you remove the `/tenants/{tenant-id}` part from the URL before you call this API. For more information, see [Known issues with Microsoft Graph](/graph/known-issues#unable-to-access-a-cross-tenant-shared-channel-when-the-request-url-contains-tenantscross-tenant-id).

api-reference/beta/api/team-list-incomingchannels.md

@@ -48,7 +48,9 @@ Don't supply a request body for this method.
 
 ## Response
 
-If successful, this method returns a `200 OK` response code and a collection of [channel](../resources/channel.md) objects in the response body. The response also includes the **@odata.id** property which can be used to access the channel and run other operations on the [channel](../resources/channel.md) object.
+If successful, this method returns a `200 OK` response code and a collection of [channel](../resources/channel.md) objects in the response body. The response also includes the **@odata.id** property which can be used to access the channel and run other operations on the [channel](../resources/channel.md) object. 
+
+When the result set spans multiple pages, the response includes an **@odata.nextLink** property with a URL for retrieving the next page of results. For details about how to page through results, see [Paging Microsoft Graph data in your app](/graph/paging).
 
 > [!Note]
 > Currently, invoking the URL returned from the **@odata.id** property fails for cross-tenant shared channels. You can solve this issue if you remove the `/tenants/{tenant-id}` part from the URL before you call this API. For more details, see [Known issues with Microsoft Graph](/graph/known-issues#unable-to-access-a-cross-tenant-shared-channel-when-the-request-url-contains-tenantscross-tenant-id).

api-reference/v1.0/api/channel-list.md

@@ -58,7 +58,9 @@ Don't supply a request body for this method.
 
 ## Response
 
-If successful, this method returns a `200 OK` response code and collection of [Channel](../resources/channel.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and collection of [Channel](../resources/channel.md) objects in the response body. 
+
+When the result set spans multiple pages, the response includes an **@odata.nextLink** property with a URL for retrieving the next page of results. For details about how to page through results, see [Paging Microsoft Graph data in your app](/graph/paging).
 
 ## Examples
 

api-reference/v1.0/api/team-list-allchannels.md

@@ -52,6 +52,8 @@ Don't supply a request body for this method.
 
 If successful, this method returns a `200 OK` response code and a collection of [channel](../resources/channel.md) objects in the response body. The response also includes the **@odata.id** property which can be used to access the channel and run other operations on the [channel](../resources/channel.md) object.
 
+When the result set spans multiple pages, the response includes an **@odata.nextLink** property with a URL for retrieving the next page of results. For details about how to page through results, see [Paging Microsoft Graph data in your app](/graph/paging).
+
 > [!Note]
 > Currently, invoking the URL returned from the **@odata.id** property fails for cross-tenant shared channels. You can solve this issue if you remove the `/tenants/{tenant-id}` part from the URL before you call this API. For more information, see [Known issues with Microsoft Graph](/graph/known-issues#unable-to-access-a-cross-tenant-shared-channel-when-the-request-url-contains-tenantscross-tenant-id).
 

api-reference/v1.0/api/team-list-incomingchannels.md

@@ -48,6 +48,8 @@ Don't supply a request body for this method.
 
 If successful, this method returns a `200 OK` response code and a collection of [channel](../resources/channel.md) objects in the response body. The response also includes the **@odata.id** property which can be used to access the channel and run other operations on the [channel](../resources/channel.md) object.
 
+When the result set spans multiple pages, the response includes an **@odata.nextLink** property with a URL for retrieving the next page of results. For details about how to page through results, see [Paging Microsoft Graph data in your app](/graph/paging).
+
 > [!Note]
 > Currently, invoking the URL returned from the **@odata.id** property fails for cross-tenant shared channels. You can solve this issue if you remove the `/tenants/{tenant-id}` part from the URL before you call this API. For more details, see [Known issues with Microsoft Graph](/graph/known-issues#unable-to-access-a-cross-tenant-shared-channel-when-the-request-url-contains-tenantscross-tenant-id).
 

changelog/Microsoft.Teams.Core.json

@@ -5879,6 +5879,74 @@
       "CreatedDateTime": "2025-01-14T18:15:55.2254479Z",
       "WorkloadArea": "Teamwork and communications",
       "SubArea": "Messaging"
+    },
+    {
+      "ChangeList": [
+        {
+          "Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
+          "ApiChange": "Method",
+          "ChangedApiName": "GET",
+          "ChangeType": "Change",
+          "Description": "Updated the [List channels](https://learn.microsoft.com/en-us/graph/api/channel-list?view=graph-rest-beta) method on the [channel](https://learn.microsoft.com/en-us/graph/api/resources/channel?view=graph-rest-beta) resource to support **@odata.nextLink** pagination. With increased channel limits, responses might span multiple pages. Use **@odata.nextLink** to retrieve all results.",
+          "Target": "channel"
+        },
+        {
+          "Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
+          "ApiChange": "Method",
+          "ChangedApiName": "List incomingChannels",
+          "ChangeType": "Change",
+          "Description": "Updated the [List incomingChannels](https://learn.microsoft.com/en-us/graph/api/team-list-incomingchannels?view=graph-rest-beta) method on the [team](https://learn.microsoft.com/en-us/graph/api/resources/team?view=graph-rest-beta) resource to support **@odata.nextLink** pagination. With increased channel limits, responses might span multiple pages. Use **@odata.nextLink** to retrieve all results.",
+          "Target": "team"
+        },
+        {
+          "Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
+          "ApiChange": "Method",
+          "ChangedApiName": "List allChannels",
+          "ChangeType": "Change",
+          "Description": "Updated the [List allChannels](https://learn.microsoft.com/en-us/graph/api/team-list-allchannels?view=graph-rest-beta) method on the [team](https://learn.microsoft.com/en-us/graph/api/resources/team?view=graph-rest-beta) resource to support **@odata.nextLink** pagination. With increased channel limits, responses might span multiple pages. Use **@odata.nextLink** to retrieve all results.",
+          "Target": "team"
+        }
+      ],
+      "Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
+      "Cloud": "Prod",
+      "Version": "beta",
+      "CreatedDateTime": "2026-04-20T00:00:00.000Z",
+      "WorkloadArea": "Teamwork and communications",
+      "SubArea": "Messaging"
+    },
+    {
+      "ChangeList": [
+        {
+          "Id": "1ebea14c-d1fb-4932-be00-59d8ba313a4b",
+          "ApiChange": "Method",
+          "ChangedApiName": "GET",
+          "ChangeType": "Change",
+          "Description": "Updated the [List channels](https://learn.microsoft.com/en-us/graph/api/channel-list?view=graph-rest-1.0) method on the [channel](https://learn.microsoft.com/en-us/graph/api/resources/channel?view=graph-rest-1.0) resource to support **@odata.nextLink** pagination. With increased channel limits, responses might span multiple pages. Use **@odata.nextLink** to retrieve all results.",
+          "Target": "channel"
+        },
+        {
+          "Id": "1ebea14c-d1fb-4932-be00-59d8ba313a4b",
+          "ApiChange": "Method",
+          "ChangedApiName": "List incomingChannels",
+          "ChangeType": "Change",
+          "Description": "Updated the [List incomingChannels](https://learn.microsoft.com/en-us/graph/api/team-list-incomingchannels?view=graph-rest-1.0) method on the [team](https://learn.microsoft.com/en-us/graph/api/resources/team?view=graph-rest-1.0) resource to support **@odata.nextLink** pagination. With increased channel limits, responses might span multiple pages. Use **@odata.nextLink** to retrieve all results.",
+          "Target": "team"
+        },
+        {
+          "Id": "1ebea14c-d1fb-4932-be00-59d8ba313a4b",
+          "ApiChange": "Method",
+          "ChangedApiName": "List allChannels",
+          "ChangeType": "Change",
+          "Description": "Updated the [List allChannels](https://learn.microsoft.com/en-us/graph/api/team-list-allchannels?view=graph-rest-1.0) method on the [team](https://learn.microsoft.com/en-us/graph/api/resources/team?view=graph-rest-1.0) resource to support **@odata.nextLink** pagination. With increased channel limits, responses might span multiple pages. Use **@odata.nextLink** to retrieve all results.",
+          "Target": "team"
+        }
+      ],
+      "Id": "1ebea14c-d1fb-4932-be00-59d8ba313a4b",
+      "Cloud": "Prod",
+      "Version": "v1.0",
+      "CreatedDateTime": "2026-04-20T00:00:00.000Z",
+      "WorkloadArea": "Teamwork and communications",
+      "SubArea": "Messaging"
     }
   ]
 }

concepts/whats-new-overview.md

@@ -49,7 +49,11 @@ Manage Teams apps at the channel level within a team using the following APIs:
 
 ### Teamwork and communications | Messaging
 
-Removed the `model` parameters and payment-model guidance from Microsoft Teams export APIs and related change-notification documentation. The `model` query parameter is no longer required and is ignored if supplied. For more information, see [Payment models and licensing requirements for Microsoft Teams APIs](/graph/teams-licenses).
+- Removed the `model` parameters and payment-model guidance from Microsoft Teams export APIs and related change-notification documentation. The `model` query parameter is no longer required and is ignored if supplied. For more information, see [Payment models and licensing requirements for Microsoft Teams APIs](/graph/teams-licenses).
+- The following Microsoft Teams APIs support **@odata.nextLink** pagination to handle increased channel limits. When the result set spans multiple pages, the response includes the **@odata.nextLink** property with a URL for retrieving the next page of results:
+  - [List channels](/graph/api/channel-list)
+  - [List incomingChannels](/graph/api/team-list-incomingchannels)
+  - [List allChannels](/graph/api/team-list-allchannels)
 
 ## April 2026: New in preview only
 
@@ -98,12 +102,16 @@ Use the **sensorTypes** property on [sensorCandidate](/graph/api/resources/secur
 
 ### Teamwork and communications | Messaging
 
-Use the targeted messages APIs to manage messages in Microsoft Teams that are visible only to specified recipients within group chats or channels:
-- Use the [targetedChatMessage](/graph/api/resources/targetedchatmessage?view=graph-rest-beta&preserve-view=true) resource type to represent a targeted message in a chat or channel.
-- [Get all targeted messages](/graph/api/userteamwork-getalltargetedmessages?view=graph-rest-beta&preserve-view=true) sent to a user in group chats and channels for compliance and archiving purposes.
-- [Get all retained targeted messages](/graph/api/userteamwork-getallretainedtargetedmessages?view=graph-rest-beta&preserve-view=true) for a user, including messages deleted by the sender but preserved due to organizational retention policies.
-- [Delete a targeted message from a channel](/graph/api/userteamwork-deletetargetedmessage?view=graph-rest-beta&preserve-view=true) by providing the team ID, channel ID, and message ID.
-- [Delete a targeted message from a chat](/graph/api/chat-delete-targetedmessages?view=graph-rest-beta&preserve-view=true) by providing the chat ID and message ID.
+- Use the targeted messages APIs to manage messages in Microsoft Teams that are visible only to specified recipients within group chats or channels:
+  - Use the [targetedChatMessage](/graph/api/resources/targetedchatmessage?view=graph-rest-beta&preserve-view=true) resource type to represent a targeted message in a chat or channel.
+  - [Get all targeted messages](/graph/api/userteamwork-getalltargetedmessages?view=graph-rest-beta&preserve-view=true) sent to a user in group chats and channels for compliance and archiving purposes.
+  - [Get all retained targeted messages](/graph/api/userteamwork-getallretainedtargetedmessages?view=graph-rest-beta&preserve-view=true) for a user, including messages deleted by the sender but preserved due to organizational retention policies.
+  - [Delete a targeted message from a channel](/graph/api/userteamwork-deletetargetedmessage?view=graph-rest-beta&preserve-view=true) by providing the team ID, channel ID, and message ID.
+  - [Delete a targeted message from a chat](/graph/api/chat-delete-targetedmessages?view=graph-rest-beta&preserve-view=true) by providing the chat ID and message ID.
+- The following Microsoft Teams APIs support **@odata.nextLink** pagination to handle increased channel limits. When the result set spans multiple pages, the response includes the **@odata.nextLink** property with a URL for retrieving the next page of results:
+  - [List channels](/graph/api/channel-list?view=graph-rest-beta&preserve-view=true)
+  - [List incomingChannels](/graph/api/team-list-incomingchannels?view=graph-rest-beta&preserve-view=true)
+  - [List allChannels](/graph/api/team-list-allchannels?view=graph-rest-beta&preserve-view=true)
 
 ## March 2026: New and generally available