Deprecate the unflag APIs since the backend endpoint is no longer supported by andremion · Pull Request #6661 · GetStream/stream-chat-android

andremion · 2026-08-25T15:46:22Z

Goal

The backend endpoint POST /moderation/unflag is deprecated and is a no-op. The SDK still exposes public APIs that call it, so an integrator can call something that silently does nothing.

This PR marks those APIs as deprecated. The removal happens in the next major version.

Resolves AND-1448

Implementation

Added @Deprecated (WARNING level) to the public APIs that reach the endpoint:

ChatClient.unflagUser and ChatClient.unflagMessage
MessageListController.unflagUser and MessageListController.ErrorEvent.UnflagUserError
Compose MessageListViewModel.unflagUser
XML MessageListViewModel.Event.UnflagUser

Added @Suppress("DEPRECATION") where the SDK itself still routes through them, so the build stays free of new warnings: MessageListController.unflagUser, Compose MessageListViewModel.unflagUser, XML MessageListViewModel.onEvent, the errorEventHandler in MessageListView, and ChatClientModerationApiTests.

ChatApi, MoshiChatApi and ModerationApi are internal, so they are left as they are. They get removed together with the public APIs.

No behaviour changes. The .api dumps are unchanged, since the validator does not record annotations.

Testing

./gradlew spotlessApply apiDump (no .api changes)
./gradlew detekt
./gradlew :stream-chat-android-client:testDebugUnitTest --tests '*ChatClientModerationApiTests*' --tests '*MoshiChatApiTest*'

Summary by CodeRabbit

Bug Fixes
- Clarified that unflagging users and messages is no longer supported by the backend.
- Existing unflag actions remain available but have no effect.
Deprecations
- Added deprecation warnings across moderation and message-list APIs.
- Unflagging functionality is planned for removal in the next major release.

…oint The backend no longer supports un-flagging, so these calls do nothing. Mark the public APIs as deprecated and suppress the warning at the internal call sites. They get removed in the next major version.

andremion · 2026-08-25T15:46:31Z

@CodeRabbit review

coderabbitai · 2026-08-25T15:46:38Z

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

github-actions · 2026-08-25T15:46:39Z

PR checklist ✅

All required conditions are satisfied:

Title length is OK (or ignored by label).
At least one pr: label exists.
Sections ### Goal, ### Implementation, and ### Testing are filled, or the PR is bot-authored.
An issue is linked (Linear ticket or GitHub issue), or the PR is bot-authored.

🎉 Great job! This PR is ready for review.

coderabbitai · 2026-08-25T15:52:56Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 491f408d-0988-4249-8916-3c37e9c75fdd

📥 Commits

Reviewing files that changed from the base of the PR and between 89b0344 and 024d367.

📒 Files selected for processing (6)

stream-chat-android-client/src/main/java/io/getstream/chat/android/client/ChatClient.kt
stream-chat-android-client/src/test/java/io/getstream/chat/android/client/ChatClientModerationApiTests.kt
stream-chat-android-compose/src/main/java/io/getstream/chat/android/compose/viewmodel/messages/MessageListViewModel.kt
stream-chat-android-ui-common/src/main/kotlin/io/getstream/chat/android/ui/common/feature/messages/list/MessageListController.kt
stream-chat-android-ui-components/src/main/kotlin/io/getstream/chat/android/ui/feature/messages/list/MessageListView.kt
stream-chat-android-ui-components/src/main/kotlin/io/getstream/chat/android/ui/viewmodel/messages/MessageListViewModel.kt

Included review availability: Your plan provides up to 4 included reviews per hour; 3 remain after this review.

Walkthrough

The change deprecates client, Compose, and UI unflag APIs and related events because backend un-flagging is unsupported. Existing implementations remain available, while internal consumers and moderation tests suppress deprecation warnings.

Changes

Unflag API deprecation

Layer / File(s)	Summary
Client moderation API deprecations `stream-chat-android-client/.../ChatClient.kt`, `stream-chat-android-client/.../ChatClientModerationApiTests.kt`	`unflagUser` and `unflagMessage` now include deprecation warnings. Moderation API tests suppress these warnings.
Compose and common UI deprecations `stream-chat-android-compose/.../MessageListViewModel.kt`, `stream-chat-android-ui-common/.../MessageListController.kt`	Compose and common UI unflag methods and related error events now include deprecation warnings.
UI deprecation handling `stream-chat-android-ui-components/.../MessageListView.kt`, `stream-chat-android-ui-components/.../MessageListViewModel.kt`	UI event handling suppresses warnings for deprecated unflag events and error events.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk: ⚪ Minimal · up to 024d3

This change marks unsupported unflag APIs for removal in a future major release without changing current behavior. No actionable merge-blocking risk remains beyond normal checks and review.

Suggested reviewers: velikovpetar, gpunto

Poem

I’m a rabbit with a warning to share,
Unflag paths now signal, “handle with care.”
The calls still remain, though their future is brief,
Tests hush the warnings and hop past the grief,
While UI events mark the old trail bare.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	Docstring coverage is 83.33% which is sufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 6 functions across 6 files.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title clearly and concisely describes the main change: deprecating public unflag APIs because the backend endpoint is unsupported.
Description check	✅ Passed	The description clearly explains the goal, implementation, affected APIs, expected behavior, and testing. It omits the UI changes, contributor checklist, reviewer checklist, and GIF template sections,…

Full details: Description check

Explanation

The description clearly explains the goal, implementation, affected APIs, expected behavior, and testing. It omits the UI changes, contributor checklist, reviewer checklist, and GIF template sections, but these omissions are non-critical for this non-visual API deprecation.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

Create stacked PR
Commit on current branch

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch andrerego/and-1448-deprecate-the-unflag-apis-in-the-chat-sdk

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

github-actions · 2026-08-25T15:54:25Z

SDK Size Comparison 📏

SDK	Before	After	Status
stream-chat-android-client	6.07 MB	6.07 MB	🟢
stream-chat-android-ui-components	11.37 MB	11.37 MB	🟢
stream-chat-android-compose	12.85 MB	12.85 MB	🟢

sonarqubecloud · 2026-08-25T15:58:38Z

Quality Gate passed

Issues
0 New issues
5 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

Deprecate the unflag APIs backed by the no-op /moderation/unflag endp…

024d367

…oint The backend no longer supports un-flagging, so these calls do nothing. Mark the public APIs as deprecated and suppress the warning at the internal call sites. They get removed in the next major version.

andremion added the pr:improvement Improvement label Aug 25, 2026

andremion self-assigned this Aug 25, 2026

andremion changed the title ~~Deprecate the unflag APIs~~ Deprecate the unflag APIs since the backend endpoint is no longer supported Aug 25, 2026

andremion marked this pull request as ready for review August 25, 2026 15:49

andremion requested a review from a team as a code owner August 25, 2026 15:49

andremion enabled auto-merge August 25, 2026 15:49

andremion removed their assignment Aug 25, 2026

gpunto approved these changes Aug 26, 2026

View reviewed changes

andremion added this pull request to the merge queue Aug 26, 2026
Any commits made after this event will not be merged.

Navigation Menu

Uh oh!

Deprecate the unflag APIs since the backend endpoint is no longer supported - #6661

Deprecate the unflag APIs since the backend endpoint is no longer supported#6661
andremion wants to merge 1 commit into
developfrom
andrerego/and-1448-deprecate-the-unflag-apis-in-the-chat-sdk

andremion commented Aug 25, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

andremion commented Aug 25, 2026

Uh oh!

coderabbitai Bot commented Aug 25, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 25, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Aug 25, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 25, 2026

Uh oh!

sonarqubecloud Bot commented Aug 25, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

andremion commented Aug 25, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Goal

Implementation

Testing

Summary by CodeRabbit

Uh oh!

andremion commented Aug 25, 2026

Uh oh!

coderabbitai Bot commented Aug 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Aug 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR checklist ✅

Uh oh!

coderabbitai Bot commented Aug 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Uh oh!

github-actions Bot commented Aug 25, 2026

SDK Size Comparison 📏

Uh oh!

sonarqubecloud Bot commented Aug 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Quality Gate passed

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

andremion commented Aug 25, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Aug 25, 2026 •

edited

Loading

github-actions Bot commented Aug 25, 2026 •

edited

Loading

coderabbitai Bot commented Aug 25, 2026 •

edited

Loading

sonarqubecloud Bot commented Aug 25, 2026 •

edited

Loading