Skip to content

Commit 8d03c12

Browse files
author
sumanac
committed
Add changelog and pagination docs for @odata.nextLink support on channel list APIs
Added changelog entries (beta and v1.0) for @odata.nextLink pagination support on List channels, List incomingChannels, and List allChannels APIs. Updated Response sections in all six API docs to document pagination behavior.
1 parent fe0d907 commit 8d03c12

7 files changed

Lines changed: 74 additions & 6 deletions

File tree

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Don't supply a request body for this method.
6161

6262
## Response
6363

64-
If successful, this method returns a `200 OK` response code and collection of [Channel](../resources/channel.md) objects in the response body.
64+
If successful, this method returns a `200 OK` response code and collection of [Channel](../resources/channel.md) objects in the response body. The response may include 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).
6565

6666
## Examples
6767

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ Don't supply a request body for this method.
5454

5555
## Response
5656

57-
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.
57+
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. The response may include 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).
5858

5959
> [!Note]
6060
> 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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ Don't supply a request body for this method.
4848

4949
## Response
5050

51-
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.
51+
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. The response may include 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).
5252

5353
> [!Note]
5454
> 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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ Don't supply a request body for this method.
5858

5959
## Response
6060

61-
If successful, this method returns a `200 OK` response code and collection of [Channel](../resources/channel.md) objects in the response body.
61+
If successful, this method returns a `200 OK` response code and collection of [Channel](../resources/channel.md) objects in the response body. The response may include 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).
6262

6363
## Examples
6464

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ Don't supply a request body for this method.
5050

5151
## Response
5252

53-
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.
53+
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. The response may include 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).
5454

5555
> [!Note]
5656
> 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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ Don't supply a request body for this method.
4646

4747
## Response
4848

49-
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.
49+
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. The response may include 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).
5050

5151
> [!Note]
5252
> 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

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5879,6 +5879,74 @@
58795879
"CreatedDateTime": "2025-01-14T18:15:55.2254479Z",
58805880
"WorkloadArea": "Teamwork and communications",
58815881
"SubArea": "Messaging"
5882+
},
5883+
{
5884+
"ChangeList": [
5885+
{
5886+
"Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
5887+
"ApiChange": "Method",
5888+
"ChangedApiName": "List channels",
5889+
"ChangeType": "Change",
5890+
"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 may span multiple pages. Clients should handle `@odata.nextLink` to retrieve all results.",
5891+
"Target": "channel"
5892+
},
5893+
{
5894+
"Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
5895+
"ApiChange": "Method",
5896+
"ChangedApiName": "List incomingChannels",
5897+
"ChangeType": "Change",
5898+
"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 may span multiple pages. Clients should handle `@odata.nextLink` to retrieve all results.",
5899+
"Target": "team"
5900+
},
5901+
{
5902+
"Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
5903+
"ApiChange": "Method",
5904+
"ChangedApiName": "List allChannels",
5905+
"ChangeType": "Change",
5906+
"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 may span multiple pages. Clients should handle `@odata.nextLink` to retrieve all results.",
5907+
"Target": "team"
5908+
}
5909+
],
5910+
"Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
5911+
"Cloud": "Prod",
5912+
"Version": "beta",
5913+
"CreatedDateTime": "2026-04-13T00:00:00.000Z",
5914+
"WorkloadArea": "Teamwork and communications",
5915+
"SubArea": "Messaging"
5916+
},
5917+
{
5918+
"ChangeList": [
5919+
{
5920+
"Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
5921+
"ApiChange": "Method",
5922+
"ChangedApiName": "List channels",
5923+
"ChangeType": "Change",
5924+
"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 may span multiple pages. Clients should handle `@odata.nextLink` to retrieve all results.",
5925+
"Target": "channel"
5926+
},
5927+
{
5928+
"Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
5929+
"ApiChange": "Method",
5930+
"ChangedApiName": "List incomingChannels",
5931+
"ChangeType": "Change",
5932+
"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 may span multiple pages. Clients should handle `@odata.nextLink` to retrieve all results.",
5933+
"Target": "team"
5934+
},
5935+
{
5936+
"Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
5937+
"ApiChange": "Method",
5938+
"ChangedApiName": "List allChannels",
5939+
"ChangeType": "Change",
5940+
"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 may span multiple pages. Clients should handle `@odata.nextLink` to retrieve all results.",
5941+
"Target": "team"
5942+
}
5943+
],
5944+
"Id": "f58e82d6-618a-4467-9662-2f2bef56b8cc",
5945+
"Cloud": "Prod",
5946+
"Version": "v1.0",
5947+
"CreatedDateTime": "2026-04-13T00:00:00.000Z",
5948+
"WorkloadArea": "Teamwork and communications",
5949+
"SubArea": "Messaging"
58825950
}
58835951
]
58845952
}

0 commit comments

Comments
 (0)