Report a User
Report a User by User ID (Flag User).
Optionally include reportType, reason, and comment in the body to categorize the
report. Sending no body flags the target as a legacy/unspecified (typeless) report and
behaves exactly as before — fully backward compatible, no version bump.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
User public id
Body
Optional report details. Sending no body flags the target as a legacy/unspecified (typeless) report — fully backward compatible.
reportType uses the internal field vocabulary; the client owns the display labels:
Send the internal values above, not the labels.
Validation (failures are 422 ValidationError):
Semantics — one report per (reporter, reportType):
- A reporter holds at most one report per
reportTypeon a target (up to 4 typed + 1 typeless). - Same reporter + same
reportTypeagain is a merge-update: providedreason/commentoverwrite; omitted fields keep their prior values. - Identical resubmission is a no-op — safe to retry, but does not re-alert moderators.
- Same reporter + different
reportTypecreates a new report. - Typeless requests (no
reportType) dedup only against the reporter's existing typeless report; typed and typeless reports never block each other. - Reports are anonymous to the reported user; reporter identity is not exposed to them.
The new fields are not echoed back in the response.
Internal field being reported. Omit for a legacy/unspecified (typeless) report. Display labels: displayName=Username, description=Bio, avatarFileId=Avatar, behavior=Behavior.
displayName, description, avatarFileId, behavior Required if and only if reportType is behavior; rejected on every other request (profile-field types and typeless). Use a value from the predefined ReportReasons taxonomy (the same list used by content flags); it is a free string on the wire, but off-list values make moderation grouping unreliable.
1 - 300Optional free-text note, allowed on all report types (including typeless).
1 - 300