---
title: "Submit a content moderation task"
method: POST
path: "/moderations"
---

# Submit a content moderation task

`POST /moderations`

## Request

- Base URL: `https://reapi.ai/api/v1`
- URL: `https://reapi.ai/api/v1/moderations`
- Auth: HTTP bearer

Submit an asynchronous reAPI task. Poll GET /tasks/{id} for status and output.

## Request body

- object
  - `model` 'omni-moderation-latest', required
  - `input` union, required
    - string
    - string[]
    - union[]
      - union
        - object
          - `type` 'text', required
          - `text` string, required
        - object
          - `type` 'image_url', required
          - `image_url` object, required
            - `url` string, uri, required
  - `stream` false
  - `webhook_url` string, uri: Optional. Public https URL with a domain-name host that receives one POST with the task response (same shape as GET /tasks/{id}) when the task reaches completed or failed. Rejected at submission: non-https schemes, IP-address hosts (IPv4 or IPv6, any notation), any port other than 443, URLs with credentials, reapi.ai hosts. Names that resolve to private, loopback, link-local or cloud-metadata addresses fail at delivery (the task itself still runs). Delivery is at-least-once (up to 3 attempts over ~5 minutes); deduplicate on the body id (the task id). reAPI sends no credentials and does not sign calls: treat a call as a signal and confirm it with an authenticated GET /tasks/{id}, or optionally embed a secret of your own in the URL. The webhook is a notification, not the only copy of the result: if delivery fails, GET /tasks/{id} still returns the task at any time (GET /tasks/{id}?include=webhook shows the delivery outcome).

## Response `200`

Task accepted

- object
  - `id` string, required
  - `model` string, required
  - `status` 'processing', required
  - `created_at` integer, required

## Other responses

- `400`: Invalid request body or unsupported model
- `401`: Missing or invalid API key
- `402`: Insufficient credits
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/reapi/apis/reapi-http-api.md) - [All operations](https://skmtc.dev/reapi/apis/reapi-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reapi/apis/reapi-http-api/revisions/1d2713a6058a?raw)