MAmatrix
Reporting content

Report a user as inappropriate.

Reports a user as inappropriate to the server, which may then notify the appropriate people. How such information is delivered is left up to implementations. The caller is not required to be joined to any rooms that the reported user is joined to.

Clients may wish to ignore users after reporting them.

Clients could infer whether a reported user exists based on the 404 response. Homeservers that wish to conceal this information MAY return 200 responses regardless of the existence of the reported user.

Furthermore, it might be possible for clients to deduce whether a reported user exists by timing the response. This is because only a report for an existing user will require the homeserver to do further processing. To combat this, homeservers MAY add a random delay when generating a response.

post/_matrix/client/v3/users/{userId}/report

Request

Path parameters

userIdstring mx-user-id required

The user being reported.

Request body

reasonstring required

The reason the room is being reported. May be blank.

Example request

{
  "reason": "this makes me sad"
}

Response

The user has been reported successfully or the server chose to not disclose whether the users exists.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.