Skip to main content
POST
Report a User

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

userId
string
required

User public id

Body

application/json

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 reportType on a target (up to 4 typed + 1 typeless).
  • Same reporter + same reportType again is a merge-update: provided reason/comment overwrite; omitted fields keep their prior values.
  • Identical resubmission is a no-op — safe to retry, but does not re-alert moderators.
  • Same reporter + different reportType creates 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.

reportType
enum<string>

Internal field being reported. Omit for a legacy/unspecified (typeless) report. Display labels: displayName=Username, description=Bio, avatarFileId=Avatar, behavior=Behavior.

Available options:
displayName,
description,
avatarFileId,
behavior
reason
string

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.

Required string length: 1 - 300
comment
string

Optional free-text note, allowed on all report types (including typeless).

Required string length: 1 - 300

Response

Flag user response

users
object[]
files
object[]