---
title: "Report an event in a joined room as inappropriate."
method: POST
path: "/_matrix/client/v3/rooms/{roomId}/report/{eventId}"
tags: ["Reporting content"]
---

# Report an event in a joined room as inappropriate.

`POST /_matrix/client/v3/rooms/{roomId}/report/{eventId}`

## Request

- Base URL: `https://matrix.org`
- URL: `https://matrix.org/_matrix/client/v3/rooms/{roomId}/report/{eventId}`
- Auth: one of:
  - API key in query parameter `access_token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/matrix/apis/matrix-client-server-api/docs/_matrix/client/v3/rooms/:roomId/report/:eventId/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `roomId` string, required
- `eventId` string, required

## Request body

- object
  - `reason` string: The reason the content is being reported.

## Response `200`

The event has been reported successfully.

- object

## Other responses

- `404`: The event was not found or you are not joined to the room where the event resides. Homeserver implementations can additionally return this error if the reported event has been redacted.

---

[API](https://skmtc.dev/matrix/apis/matrix-client-server-api.md) - [All operations](https://skmtc.dev/matrix/apis/matrix-client-server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/matrix/apis/matrix-client-server-api/revisions/c7fe4072c681?raw)