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

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

## Endpoint

### Report a Post

```
POST /report-post
```

Submit a report for a post using its share code. An optional reason can be provided to help moderators review the report.

**Request body:**

```json theme={null}
{
  "code": "AbCd1234",
  "reason": "This post contains inappropriate content"
}
```

| Field    | Type   | Required | Description                                |
| -------- | ------ | -------- | ------------------------------------------ |
| `code`   | string | Yes      | The share code of the post 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 code         | `code` is empty or missing                       |
| `400` | Reason too long                 | `reason` exceeds 200 characters                  |
| `403` | Post is already moderated       | The post has already been actioned by moderators |
| `403` | You cannot report your own post | `code` belongs to a post you own                 |
| `403` | You cannot report this post     | A block exists between you and the post author   |
| `404` | Post not found                  | Post does not exist or is private                |
| `429` | Rate limit exceeded             | Too many requests                                |

## Examples

Report a post:

```bash theme={null}
curl -X POST "https://api.snipp.gg/report-post" \
  -H "api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code": "AbCd1234", "reason": "Inappropriate content"}'
```

Report a post without a reason:

```bash theme={null}
curl -X POST "https://api.snipp.gg/report-post" \
  -H "api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code": "AbCd1234"}'
```

## Responses

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