Skip to content

Regenerate SDK: Moderation API + grouped request parameters #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
winrid merged 9 commits into from
Jun 30, 2026
Merged

Regenerate SDK: Moderation API + grouped request parameters #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
cfd0821
Regenerate against latest spec: moderation tenantId + broadcastId par…
winrid Jun 22, 2026
717b52e
Regenerate with grouped request objects (useSingleRequestParameter)
winrid Jun 23, 2026
a097175
Regenerate docs with grouped request-object examples
winrid Jun 23, 2026
fae0845
Regenerate: required params + body positional, optionals in one object
winrid Jun 23, 2026
8d4723a
Regenerate: single optional is a direct param (no options object for …
winrid Jun 23, 2026
46cbd3b
Regenerate: drop trailing comma in 0-optional op signatures/calls
winrid Jun 29, 2026
fde1279
Regenerate: mod_api/ paths + PostRemoveCommentApiResponse rename; dro…
winrid Jun 30, 2026
06e07f4
README: shorten the ModerationApi description
winrid Jun 30, 2026
5571505
Release v3.0.0: regenerate at 3.0.0 with fastcomments-build-20260630 jar
winrid Jun 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 8 additions & 16 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,26 +41,16 @@ SSO helpers are included in the package (`package:fastcomments_dart/sso/...`).

The client exposes three API classes:

- `DefaultApi` — API-key-authenticated methods for server-side use.
- `PublicApi` — public methods that need no API key, safe for browser and
- `DefaultApi` - API-key-authenticated methods for server-side use.
- `PublicApi` - public methods that need no API key, safe for browser and
mobile clients.
- `ModerationApi` — methods that back the moderator dashboard: comment
moderation (list, count, search, logs, export), moderation actions
(remove/restore, flag, set review/spam/approval status, votes, reopen/close
thread), bans (ban from comment, undo, pre-ban summaries, ban status and
preferences, banned-user counts), and badges & trust (award/remove badge,
manual badges, get/set trust factor, user internal profile). Every
`ModerationApi` method takes an `sso` parameter for SSO-authenticated
moderators.
- `ModerationApi` - an extensive suite of live and fast moderation APIs. Every `ModerationApi` method takes an `sso` parameter and can authenticate via SSO or a FastComments.com session cookie.

```dart
import 'package:fastcomments_dart/api.dart';

final api = DefaultApi(ApiClient(basePath: 'https://fastcomments.com'));
final comments = await api.getCommentsPublic(
'YOUR_TENANT_ID',
urlId: 'YOUR_URL_ID',
);
final api = PublicApi(ApiClient(basePath: 'https://fastcomments.com'));
final comments = await api.getCommentsPublic('YOUR_TENANT_ID', 'YOUR_URL_ID');
```

```dart
Expand All @@ -74,7 +64,9 @@ final feedPosts = await publicApi.getFeedPostsPublic('YOUR_TENANT_ID');
import 'package:fastcomments_dart/api.dart';

final moderation = ModerationApi(ApiClient(basePath: 'https://fastcomments.com'));
final result = await moderation.getApiComments(sso: 'SSO_TOKEN');
final result = await moderation.getApiComments(
GetApiCommentsOptions(sso: 'SSO_TOKEN'),
);
```

## SSO
Expand Down
6 changes: 3 additions & 3 deletions client/.openapi-generator/FILES
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -264,7 +264,7 @@ doc/PatchDomainConfigResponse.md
doc/PatchPageAPIResponse.md
doc/PatchSSOUserAPIResponse.md
doc/PendingCommentToSyncOutbound.md
doc/PostRemoveCommentResponse.md
doc/PostRemoveCommentApiResponse.md
doc/PreBanSummary.md
doc/PubSubComment.md
doc/PubSubCommentBase.md
Expand Down Expand Up @@ -638,7 +638,7 @@ lib/model/patch_domain_config_response.dart
lib/model/patch_page_api_response.dart
lib/model/patch_sso_user_api_response.dart
lib/model/pending_comment_to_sync_outbound.dart
lib/model/post_remove_comment_response.dart
lib/model/post_remove_comment_api_response.dart
lib/model/pre_ban_summary.dart
lib/model/pub_sub_comment.dart
lib/model/pub_sub_comment_base.dart
Expand Down Expand Up @@ -1001,7 +1001,7 @@ test/patch_domain_config_response_test.dart
test/patch_page_api_response_test.dart
test/patch_sso_user_api_response_test.dart
test/pending_comment_to_sync_outbound_test.dart
test/post_remove_comment_response_test.dart
test/post_remove_comment_api_response_test.dart
test/pre_ban_summary_test.dart
test/pub_sub_comment_base_test.dart
test/pub_sub_comment_test.dart
Expand Down
88 changes: 44 additions & 44 deletions client/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -178,49 +178,49 @@ Class | Method | HTTP request | Description
*DefaultApi* | [**updateTenantPackage**](doc//DefaultApi.md#updatetenantpackage) | **PATCH** /api/v1/tenant-packages/{id} |
*DefaultApi* | [**updateTenantUser**](doc//DefaultApi.md#updatetenantuser) | **PATCH** /api/v1/tenant-users/{id} |
*DefaultApi* | [**updateUserBadge**](doc//DefaultApi.md#updateuserbadge) | **PUT** /api/v1/user-badges/{id} |
*ModerationApi* | [**deleteModerationVote**](doc//ModerationApi.md#deletemoderationvote) | **DELETE** /auth/my-account/moderate-comments/vote/{commentId}/{voteId} |
*ModerationApi* | [**getApiComments**](doc//ModerationApi.md#getapicomments) | **GET** /auth/my-account/moderate-comments/api/comments |
*ModerationApi* | [**getApiExportStatus**](doc//ModerationApi.md#getapiexportstatus) | **GET** /auth/my-account/moderate-comments/api/export/status |
*ModerationApi* | [**getApiIds**](doc//ModerationApi.md#getapiids) | **GET** /auth/my-account/moderate-comments/api/ids |
*ModerationApi* | [**getBanUsersFromComment**](doc//ModerationApi.md#getbanusersfromcomment) | **GET** /auth/my-account/moderate-comments/ban-users/from-comment/{commentId} |
*ModerationApi* | [**getCommentBanStatus**](doc//ModerationApi.md#getcommentbanstatus) | **GET** /auth/my-account/moderate-comments/get-comment-ban-status/{commentId} |
*ModerationApi* | [**getCommentChildren**](doc//ModerationApi.md#getcommentchildren) | **GET** /auth/my-account/moderate-comments/comment-children/{commentId} |
*ModerationApi* | [**getCount**](doc//ModerationApi.md#getcount) | **GET** /auth/my-account/moderate-comments/count |
*ModerationApi* | [**getCounts**](doc//ModerationApi.md#getcounts) | **GET** /auth/my-account/moderate-comments/banned-users/counts |
*ModerationApi* | [**getLogs**](doc//ModerationApi.md#getlogs) | **GET** /auth/my-account/moderate-comments/logs/{commentId} |
*ModerationApi* | [**getManualBadges**](doc//ModerationApi.md#getmanualbadges) | **GET** /auth/my-account/moderate-comments/get-manual-badges |
*ModerationApi* | [**getManualBadgesForUser**](doc//ModerationApi.md#getmanualbadgesforuser) | **GET** /auth/my-account/moderate-comments/get-manual-badges-for-user |
*ModerationApi* | [**getModerationComment**](doc//ModerationApi.md#getmoderationcomment) | **GET** /auth/my-account/moderate-comments/comment/{commentId} |
*ModerationApi* | [**getModerationCommentText**](doc//ModerationApi.md#getmoderationcommenttext) | **GET** /auth/my-account/moderate-comments/get-comment-text/{commentId} |
*ModerationApi* | [**getPreBanSummary**](doc//ModerationApi.md#getprebansummary) | **GET** /auth/my-account/moderate-comments/pre-ban-summary/{commentId} |
*ModerationApi* | [**getSearchCommentsSummary**](doc//ModerationApi.md#getsearchcommentssummary) | **GET** /auth/my-account/moderate-comments/search/comments/summary |
*ModerationApi* | [**getSearchPages**](doc//ModerationApi.md#getsearchpages) | **GET** /auth/my-account/moderate-comments/search/pages |
*ModerationApi* | [**getSearchSites**](doc//ModerationApi.md#getsearchsites) | **GET** /auth/my-account/moderate-comments/search/sites |
*ModerationApi* | [**getSearchSuggest**](doc//ModerationApi.md#getsearchsuggest) | **GET** /auth/my-account/moderate-comments/search/suggest |
*ModerationApi* | [**getSearchUsers**](doc//ModerationApi.md#getsearchusers) | **GET** /auth/my-account/moderate-comments/search/users |
*ModerationApi* | [**getTrustFactor**](doc//ModerationApi.md#gettrustfactor) | **GET** /auth/my-account/moderate-comments/get-trust-factor |
*ModerationApi* | [**getUserBanPreference**](doc//ModerationApi.md#getuserbanpreference) | **GET** /auth/my-account/moderate-comments/user-ban-preference |
*ModerationApi* | [**getUserInternalProfile**](doc//ModerationApi.md#getuserinternalprofile) | **GET** /auth/my-account/moderate-comments/get-user-internal-profile |
*ModerationApi* | [**postAdjustCommentVotes**](doc//ModerationApi.md#postadjustcommentvotes) | **POST** /auth/my-account/moderate-comments/adjust-comment-votes/{commentId} |
*ModerationApi* | [**postApiExport**](doc//ModerationApi.md#postapiexport) | **POST** /auth/my-account/moderate-comments/api/export |
*ModerationApi* | [**postBanUserFromComment**](doc//ModerationApi.md#postbanuserfromcomment) | **POST** /auth/my-account/moderate-comments/ban-user/from-comment/{commentId} |
*ModerationApi* | [**postBanUserUndo**](doc//ModerationApi.md#postbanuserundo) | **POST** /auth/my-account/moderate-comments/ban-user/undo |
*ModerationApi* | [**postBulkPreBanSummary**](doc//ModerationApi.md#postbulkprebansummary) | **POST** /auth/my-account/moderate-comments/bulk-pre-ban-summary |
*ModerationApi* | [**postCommentsByIds**](doc//ModerationApi.md#postcommentsbyids) | **POST** /auth/my-account/moderate-comments/comments-by-ids |
*ModerationApi* | [**postFlagComment**](doc//ModerationApi.md#postflagcomment) | **POST** /auth/my-account/moderate-comments/flag-comment/{commentId} |
*ModerationApi* | [**postRemoveComment**](doc//ModerationApi.md#postremovecomment) | **POST** /auth/my-account/moderate-comments/remove-comment/{commentId} |
*ModerationApi* | [**postRestoreDeletedComment**](doc//ModerationApi.md#postrestoredeletedcomment) | **POST** /auth/my-account/moderate-comments/restore-deleted-comment/{commentId} |
*ModerationApi* | [**postSetCommentApprovalStatus**](doc//ModerationApi.md#postsetcommentapprovalstatus) | **POST** /auth/my-account/moderate-comments/set-comment-approval-status/{commentId} |
*ModerationApi* | [**postSetCommentReviewStatus**](doc//ModerationApi.md#postsetcommentreviewstatus) | **POST** /auth/my-account/moderate-comments/set-comment-review-status/{commentId} |
*ModerationApi* | [**postSetCommentSpamStatus**](doc//ModerationApi.md#postsetcommentspamstatus) | **POST** /auth/my-account/moderate-comments/set-comment-spam-status/{commentId} |
*ModerationApi* | [**postSetCommentText**](doc//ModerationApi.md#postsetcommenttext) | **POST** /auth/my-account/moderate-comments/set-comment-text/{commentId} |
*ModerationApi* | [**postUnFlagComment**](doc//ModerationApi.md#postunflagcomment) | **POST** /auth/my-account/moderate-comments/un-flag-comment/{commentId} |
*ModerationApi* | [**postVote**](doc//ModerationApi.md#postvote) | **POST** /auth/my-account/moderate-comments/vote/{commentId} |
*ModerationApi* | [**putAwardBadge**](doc//ModerationApi.md#putawardbadge) | **PUT** /auth/my-account/moderate-comments/award-badge |
*ModerationApi* | [**putCloseThread**](doc//ModerationApi.md#putclosethread) | **PUT** /auth/my-account/moderate-comments/close-thread |
*ModerationApi* | [**putRemoveBadge**](doc//ModerationApi.md#putremovebadge) | **PUT** /auth/my-account/moderate-comments/remove-badge |
*ModerationApi* | [**putReopenThread**](doc//ModerationApi.md#putreopenthread) | **PUT** /auth/my-account/moderate-comments/reopen-thread |
*ModerationApi* | [**setTrustFactor**](doc//ModerationApi.md#settrustfactor) | **PUT** /auth/my-account/moderate-comments/set-trust-factor |
*ModerationApi* | [**deleteModerationVote**](doc//ModerationApi.md#deletemoderationvote) | **DELETE** /auth/my-account/moderate-comments/mod_api/vote/{commentId}/{voteId} |
*ModerationApi* | [**getApiComments**](doc//ModerationApi.md#getapicomments) | **GET** /auth/my-account/moderate-comments/mod_api/api/comments |
*ModerationApi* | [**getApiExportStatus**](doc//ModerationApi.md#getapiexportstatus) | **GET** /auth/my-account/moderate-comments/mod_api/api/export/status |
*ModerationApi* | [**getApiIds**](doc//ModerationApi.md#getapiids) | **GET** /auth/my-account/moderate-comments/mod_api/api/ids |
*ModerationApi* | [**getBanUsersFromComment**](doc//ModerationApi.md#getbanusersfromcomment) | **GET** /auth/my-account/moderate-comments/mod_api/ban-users/from-comment/{commentId} |
*ModerationApi* | [**getCommentBanStatus**](doc//ModerationApi.md#getcommentbanstatus) | **GET** /auth/my-account/moderate-comments/mod_api/get-comment-ban-status/{commentId} |
*ModerationApi* | [**getCommentChildren**](doc//ModerationApi.md#getcommentchildren) | **GET** /auth/my-account/moderate-comments/mod_api/comment-children/{commentId} |
*ModerationApi* | [**getCount**](doc//ModerationApi.md#getcount) | **GET** /auth/my-account/moderate-comments/mod_api/count |
*ModerationApi* | [**getCounts**](doc//ModerationApi.md#getcounts) | **GET** /auth/my-account/moderate-comments/banned-users/mod_api/counts |
*ModerationApi* | [**getLogs**](doc//ModerationApi.md#getlogs) | **GET** /auth/my-account/moderate-comments/mod_api/logs/{commentId} |
*ModerationApi* | [**getManualBadges**](doc//ModerationApi.md#getmanualbadges) | **GET** /auth/my-account/moderate-comments/mod_api/get-manual-badges |
*ModerationApi* | [**getManualBadgesForUser**](doc//ModerationApi.md#getmanualbadgesforuser) | **GET** /auth/my-account/moderate-comments/mod_api/get-manual-badges-for-user |
*ModerationApi* | [**getModerationComment**](doc//ModerationApi.md#getmoderationcomment) | **GET** /auth/my-account/moderate-comments/mod_api/comment/{commentId} |
*ModerationApi* | [**getModerationCommentText**](doc//ModerationApi.md#getmoderationcommenttext) | **GET** /auth/my-account/moderate-comments/mod_api/get-comment-text/{commentId} |
*ModerationApi* | [**getPreBanSummary**](doc//ModerationApi.md#getprebansummary) | **GET** /auth/my-account/moderate-comments/mod_api/pre-ban-summary/{commentId} |
*ModerationApi* | [**getSearchCommentsSummary**](doc//ModerationApi.md#getsearchcommentssummary) | **GET** /auth/my-account/moderate-comments/mod_api/search/comments/summary |
*ModerationApi* | [**getSearchPages**](doc//ModerationApi.md#getsearchpages) | **GET** /auth/my-account/moderate-comments/mod_api/search/pages |
*ModerationApi* | [**getSearchSites**](doc//ModerationApi.md#getsearchsites) | **GET** /auth/my-account/moderate-comments/mod_api/search/sites |
*ModerationApi* | [**getSearchSuggest**](doc//ModerationApi.md#getsearchsuggest) | **GET** /auth/my-account/moderate-comments/mod_api/search/suggest |
*ModerationApi* | [**getSearchUsers**](doc//ModerationApi.md#getsearchusers) | **GET** /auth/my-account/moderate-comments/mod_api/search/users |
*ModerationApi* | [**getTrustFactor**](doc//ModerationApi.md#gettrustfactor) | **GET** /auth/my-account/moderate-comments/mod_api/get-trust-factor |
*ModerationApi* | [**getUserBanPreference**](doc//ModerationApi.md#getuserbanpreference) | **GET** /auth/my-account/moderate-comments/mod_api/user-ban-preference |
*ModerationApi* | [**getUserInternalProfile**](doc//ModerationApi.md#getuserinternalprofile) | **GET** /auth/my-account/moderate-comments/mod_api/get-user-internal-profile |
*ModerationApi* | [**postAdjustCommentVotes**](doc//ModerationApi.md#postadjustcommentvotes) | **POST** /auth/my-account/moderate-comments/mod_api/adjust-comment-votes/{commentId} |
*ModerationApi* | [**postApiExport**](doc//ModerationApi.md#postapiexport) | **POST** /auth/my-account/moderate-comments/mod_api/api/export |
*ModerationApi* | [**postBanUserFromComment**](doc//ModerationApi.md#postbanuserfromcomment) | **POST** /auth/my-account/moderate-comments/mod_api/ban-user/from-comment/{commentId} |
*ModerationApi* | [**postBanUserUndo**](doc//ModerationApi.md#postbanuserundo) | **POST** /auth/my-account/moderate-comments/mod_api/ban-user/undo |
*ModerationApi* | [**postBulkPreBanSummary**](doc//ModerationApi.md#postbulkprebansummary) | **POST** /auth/my-account/moderate-comments/mod_api/bulk-pre-ban-summary |
*ModerationApi* | [**postCommentsByIds**](doc//ModerationApi.md#postcommentsbyids) | **POST** /auth/my-account/moderate-comments/mod_api/comments-by-ids |
*ModerationApi* | [**postFlagComment**](doc//ModerationApi.md#postflagcomment) | **POST** /auth/my-account/moderate-comments/mod_api/flag-comment/{commentId} |
*ModerationApi* | [**postRemoveComment**](doc//ModerationApi.md#postremovecomment) | **POST** /auth/my-account/moderate-comments/mod_api/remove-comment/{commentId} |
*ModerationApi* | [**postRestoreDeletedComment**](doc//ModerationApi.md#postrestoredeletedcomment) | **POST** /auth/my-account/moderate-comments/mod_api/restore-deleted-comment/{commentId} |
*ModerationApi* | [**postSetCommentApprovalStatus**](doc//ModerationApi.md#postsetcommentapprovalstatus) | **POST** /auth/my-account/moderate-comments/mod_api/set-comment-approval-status/{commentId} |
*ModerationApi* | [**postSetCommentReviewStatus**](doc//ModerationApi.md#postsetcommentreviewstatus) | **POST** /auth/my-account/moderate-comments/mod_api/set-comment-review-status/{commentId} |
*ModerationApi* | [**postSetCommentSpamStatus**](doc//ModerationApi.md#postsetcommentspamstatus) | **POST** /auth/my-account/moderate-comments/mod_api/set-comment-spam-status/{commentId} |
*ModerationApi* | [**postSetCommentText**](doc//ModerationApi.md#postsetcommenttext) | **POST** /auth/my-account/moderate-comments/mod_api/set-comment-text/{commentId} |
*ModerationApi* | [**postUnFlagComment**](doc//ModerationApi.md#postunflagcomment) | **POST** /auth/my-account/moderate-comments/mod_api/un-flag-comment/{commentId} |
*ModerationApi* | [**postVote**](doc//ModerationApi.md#postvote) | **POST** /auth/my-account/moderate-comments/mod_api/vote/{commentId} |
*ModerationApi* | [**putAwardBadge**](doc//ModerationApi.md#putawardbadge) | **PUT** /auth/my-account/moderate-comments/mod_api/award-badge |
*ModerationApi* | [**putCloseThread**](doc//ModerationApi.md#putclosethread) | **PUT** /auth/my-account/moderate-comments/mod_api/close-thread |
*ModerationApi* | [**putRemoveBadge**](doc//ModerationApi.md#putremovebadge) | **PUT** /auth/my-account/moderate-comments/mod_api/remove-badge |
*ModerationApi* | [**putReopenThread**](doc//ModerationApi.md#putreopenthread) | **PUT** /auth/my-account/moderate-comments/mod_api/reopen-thread |
*ModerationApi* | [**setTrustFactor**](doc//ModerationApi.md#settrustfactor) | **PUT** /auth/my-account/moderate-comments/mod_api/set-trust-factor |
*PublicApi* | [**blockFromCommentPublic**](doc//PublicApi.md#blockfromcommentpublic) | **POST** /block-from-comment/{commentId} |
*PublicApi* | [**checkedCommentsForBlocked**](doc//PublicApi.md#checkedcommentsforblocked) | **GET** /check-blocked-comments |
*PublicApi* | [**createCommentPublic**](doc//PublicApi.md#createcommentpublic) | **POST** /comments/{tenantId} |
Expand Down Expand Up @@ -536,7 +536,7 @@ Class | Method | HTTP request | Description
- [PatchPageAPIResponse](doc//PatchPageAPIResponse.md)
- [PatchSSOUserAPIResponse](doc//PatchSSOUserAPIResponse.md)
- [PendingCommentToSyncOutbound](doc//PendingCommentToSyncOutbound.md)
- [PostRemoveCommentResponse](doc//PostRemoveCommentResponse.md)
- [PostRemoveCommentApiResponse](doc//PostRemoveCommentApiResponse.md)
- [PreBanSummary](doc//PreBanSummary.md)
- [PubSubComment](doc//PubSubComment.md)
- [PubSubCommentBase](doc//PubSubCommentBase.md)
Expand Down
Loading
Loading