Skip to content

Add Moderation API and stable response types#4

Merged
winrid merged 3 commits into
mainfrom
regen-moderation-api
Jun 19, 2026
Merged

Add Moderation API and stable response types#4
winrid merged 3 commits into
mainfrom
regen-moderation-api

Conversation

@winrid

@winrid winrid commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Moderation API

Adds a Moderation API with methods for the moderator dashboard:

  • Comments — list, count, fetch by id(s) and children, get/set comment text, logs, export, search (users / pages / sites / comments), suggestions
  • Moderation actions — remove / restore, flag / un-flag, set review / spam / approval status, adjust / cast / delete votes, reopen / close thread
  • Bans — ban from comment, undo ban, pre-ban and bulk pre-ban summaries, comment ban status, ban preferences, banned-user counts and lookup
  • Badges & trust — award / remove badge, manual badges, get / set trust factor, user internal profile

All Moderation methods accept an sso parameter for SSO-authenticated moderators.

Response types (breaking)

Each method now returns its success response type directly, with errors surfaced as a default error response, instead of the previous combined success-or-error return type. The response type names are now stable. Response shapes are unchanged.

Recommend a major version bump.

Regenerated the Python client from the updated OpenAPI spec
(fastcomments-openapi-clean / fastcomments-sdk 4.0.0).

- Adds the new Moderation API (client/api/moderation_api.py) with 43
  moderator-dashboard endpoints: comment moderation, bans, badges,
  trust factor, search; all accept an sso query param.
- BREAKING: operations now return their success type directly instead
  of an X | APIError union, removing arbitrary 200-response wrapper
  types. APIError is now a default error response. Response shapes are
  unchanged.
- Updated committed openapi.json.
@winrid winrid changed the title Regenerate SDK: add Moderation API + stable response types Add Moderation API and stable response types Jun 19, 2026
@winrid
winrid merged commit 62f3bc2 into main Jun 19, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant