---
title: "Report a user as inappropriate."
method: POST
path: "/_matrix/client/v3/users/{userId}/report"
tags: ["Reporting content"]
---

# Report a user as inappropriate.

`POST /_matrix/client/v3/users/{userId}/report`

## Request

- Base URL: `https://matrix.org`
- URL: `https://matrix.org/_matrix/client/v3/users/{userId}/report`
- 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/users/:userId/report/post.ts> (a function with typed inputs; its response is checked against the schema)

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](#ignoring-users) 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.

## Path parameters

- `userId` string, mx-user-id, required

## Request body

- object
  - `reason` string, required: The reason the room is being reported. May be blank.

## Response `200`

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

- object

## Other responses

- `404`: The user was not found on the homeserver.
- `429`: This request was rate-limited.

---

[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)