Reporting Content
Users may encounter content which they find inappropriate and should be able to report it to the server administrators or room moderators for review. This module defines a way for users to report content.
Content is reported based upon a negative score, where -100 is “most offensive” and 0 is “inoffensive”.
Client behaviour
POST /_matrix/client/r0/rooms/{roomId}/report/{eventId}
Reports an event as inappropriate to the server, which may then notify
the appropriate people.
| Rate-limited: | No |
|---|---|
| Requires authentication: | Yes |
Request
Request parameters
| Name | Type | Description |
|---|---|---|
eventId |
string |
Required: The event to report. |
roomId |
string |
Required: The room in which the event being reported is located. |
Request body
| Name | Type | Description |
|---|---|---|
reason |
string |
The reason the content is being reported. May be blank. |
score |
integer |
The score to rate this content as where -100 is most offensive and 0 is inoffensive. |
Request body example
{
"reason": "this makes me sad",
"score": -100
}
Responses
| Status | Description |
|---|---|
200 |
The event has been reported successfully. |
Server behaviour
Servers are free to handle the reported content however they desire. This may be a dedicated room to alert server administrators to the reported content or some other mechanism for notifying the appropriate people.