Skip to main content
Handle Comment Report
Resolves a filed report against a comment in a space. Requires the caller to be a moderator or admin of that space.

Path Parameters

string
required
UUID of the space.
string
required
UUID of the comment report to resolve.

Body Parameters

string
required
UUID of the reported comment. Used when performing remove-comment.
string[]
required
One or more actions to take. Must contain at least one value. Available actions:
  • "remove-comment" — marks the comment as removed via moderation
  • "ban-user" — bans the author of the reported content from the space and the child spaces where they are an active member, and ends their membership of those spaces’ chats, so they can no longer post to or receive them (they keep read access to messages from before the ban). The same rules as Ban Member apply, with the same errors: a moderator cannot ban a moderator or admin, only the space creator can ban an admin, and the last admin of a space cannot be banned. A refused ban rolls back the whole request, including any removal in the same request. An author who is not a member of the space (for example, who left before the report was handled) is banned all the same: the ban is kept as a banned membership, so they can’t join the space or its child spaces. If the author is already banned in the space, the ban is not repeated and the rest of the request still applies; it is still re-applied to their active memberships in child spaces, under the same rules (requires reason)
  • "dismiss" — dismisses the report without action (requires summary; cannot be combined with other actions)
string
Summary of the action taken. Required when using dismiss or any non-dismiss action.
string
Reason for the ban, kept in the space’s ban log. Required when ban-user is included in actions.

Response

Returns 201 Created:

Error Responses

Also returned when ban-user is used without reason:
ban-user bans the author of the reported content, so the request takes no userId.
The reported content has no author to ban (for example, its author deleted their account).
The commentId sent does not match what the report is about, or the report is about another kind of content.