Reporting content

Report an event in a joined room as inappropriate.

Reports an event as inappropriate to the server, which may then notify the appropriate people. The caller must be joined to the room to report it.

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

Furthermore, it might be possible for clients to deduce whether a reported event exists by timing the response. This is because only a report for an existing event 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/rooms/{roomId}/report/{eventId}

Request

Path parameters

roomIdstring required

The room in which the event being reported is located.

eventIdstring required

The event to report.

Request body

reasonstring

The reason the content is being reported.

Example request

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

Response

The event has been reported successfully.

object required

Changes

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