Add docs around pagination of the conversation list #364
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
neekolas
force-pushed
the
09-03-add_docs_around_pagination_of_the_conversation_list
branch
from
bbf8d18 to
fae3998
Compare
neekolas
force-pushed
the
09-03-add_docs_around_pagination_of_the_conversation_list
branch
from
fae3998 to
a05d974
Compare
3 tasks
3 tasks
…ocs_around_pagination_of_the_conversation_list
neekolas
commented
Nov 4, 2025
|
|
||
| Apps should only sort conversations by `lastActivityNs` when paginating if they expect not to receive new messages in the conversations unexpectedly (apps that don't utilize streaming), or where the page size is very large and missed conversations are acceptable. | ||
|
|
||
| To paginate against a stably sorted list you should use the `createdAtBeforeNs` parameter for filtering and an `orderBy` of `createdAt`, and perform the final sort of conversations in your app. |
Contributor
Author
There was a problem hiding this comment.
This is now createdBeforeNs
Document conversation list pagination and update Swift DM/group examples in list.mdx to show
|
jhaaaa
reviewed
Nov 5, 2025
jhaaaa
reviewed
Nov 5, 2025
jhaaaa
reviewed
Nov 5, 2025
jhaaaa
approved these changes
Nov 11, 2025
Collaborator
jhaaaa
left a comment
jhaaaa
left a comment
There was a problem hiding this comment.
Reviewed with Nick. Good to go!
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Add pagination documentation for the chat app conversation list to guide list retrieval behavior
Update list.mdx to document conversation list pagination and correct Swift examples. The changes include:
limitwithcreatedAtNsorlastActivityNs, default sort behavior, and instability warnings when sorting bylastActivityNs.lastActivityBeforeNsand by creation time usingcreatedAtBeforeNswithorderBy = CREATED_AT.lastActivityBeforeNs/lastActivityAtNsandcreatedAtBeforeNs/createdAtNswith appropriateorderBy.awaitfrom Swift calls toclient.conversations.listDms(consentState: .allowed)andclient.conversations.listGroups(consentState: .allowed).📍Where to Start
Start with the new pagination section and code examples in list.mdx.
Macroscope summarized 2356c30.