> ## 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 Comment

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

## Endpoint

### Report a Comment

```
POST /report-comment
```

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

**Request body:**

```json theme={null}
{
  "commentId": "00000000-0000-4000-8000-000000000000",
  "reason": "This comment is harassment"
}
```

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

**Response:**

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

## Behavior

* Reports are blocked on comments belonging to moderated posts, on private or draft posts you do not own, and on team posts you are not a member of.
* You cannot report a comment whose author has blocked you.
* You cannot report your own comment.

## Errors

| Code  | Error                                        | When                                                                                               |
| ----- | -------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `400` | Invalid comment.                             | `commentId` is empty, missing, or not a valid ID                                                   |
| `400` | Reason cannot exceed 200 characters.         | `reason` exceeds 200 characters                                                                    |
| `403` | You cannot report your own comment.          | The comment is yours                                                                               |
| `403` | Comments are disabled on moderated posts.    | The post has been moderated                                                                        |
| `403` | You cannot report this comment.              | The comment author has blocked you                                                                 |
| `404` | Comment not found.                           | The comment does not exist                                                                         |
| `404` | Post not found.                              | The post does not exist, is private or a draft you do not own, or belongs to a team you are not in |
| `429` | Rate limit exceeded. Please try again later. | Too many requests                                                                                  |

## Examples

Report a comment:

```bash theme={null}
curl -X POST "https://relay.snipp.gg/report-comment" \
  -H "relay-key: YOUR_RELAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"commentId": "00000000-0000-4000-8000-000000000000", "reason": "Harassment"}'
```

Report a comment without a reason:

```bash theme={null}
curl -X POST "https://relay.snipp.gg/report-comment" \
  -H "relay-key: YOUR_RELAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"commentId": "00000000-0000-4000-8000-000000000000"}'
```

## Responses

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