> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snipp.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Report a User

Report a user for violating community guidelines. Reports are reviewed by the moderation team.

## Endpoint

### Report a User

```
POST /report-user
```

Submit a report for a user using their ID. An optional reason can be provided to help moderators review the report.

**Request body:**

```json theme={null}
{
  "targetUserId": "123456789012345678",
  "reason": "This user is impersonating someone else"
}
```

| Field          | Type   | Required | Description                                |
| -------------- | ------ | -------- | ------------------------------------------ |
| `targetUserId` | string | Yes      | The ID of the user to report               |
| `reason`       | string | No       | Reason for the report (max 200 characters) |

**Response:**

```json theme={null}
{
  "success": true
}
```

## Errors

| Code  | Error                      | When                                                |
| ----- | -------------------------- | --------------------------------------------------- |
| `400` | Missing or invalid user    | `targetUserId` is empty, missing, or not a valid ID |
| `400` | Reason too long            | `reason` exceeds 200 characters                     |
| `403` | User is already suspended  | The user has already been actioned by moderators    |
| `403` | You cannot report yourself | `targetUserId` is your own ID                       |
| `403` | User has blocked you       | The reported user has blocked you                   |
| `404` | User not found             | The user does not exist                             |
| `429` | Rate limit exceeded        | Too many requests                                   |

## Examples

Report a user:

```bash theme={null}
curl -X POST "https://relay.snipp.gg/report-user" \
  -H "relay-key: YOUR_RELAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"targetUserId": "123456789012345678", "reason": "Impersonation"}'
```

Report a user without a reason:

```bash theme={null}
curl -X POST "https://relay.snipp.gg/report-user" \
  -H "relay-key: YOUR_RELAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"targetUserId": "123456789012345678"}'
```

## Responses

```json theme={null}
{
  "success": true
}
```