Create Reasons

Creates a new moderation reason in the app. This reason can then be selected by end users when flagging a message they find inappropriate.

POST /moderation/reasons

Create Reasons

cURL

curl --request POST \
  --url https://{appid}.api-{region}.cometchat.io/v3/moderation/reasons \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "id": "unfiltered-content",
  "name": "RawContent",
  "description": "Content delivered without moderation or filtering."
}
'

200

{
  "data": {
    "id": "unfiltered-content",
    "name": "RawContent",
    "description": "Content delivered without moderation or filtering.",
    "createdAt": 1760449410,
    "updatedAt": 1760449410
  }
}

Authorizations

apikey · string · header · required

API Key with fullAccess scope(i.e. Rest API Key from the Dashboard).

Body

application/json

id · string · required

Unique identifier for the content type.

Example:

"unfiltered-content"

name · string · required

Display name for the content type.

Example:

"RawContent"

description · string

Description of the content type.

Example:

"Content delivered without moderation or filtering."

Response

200 - application/json

Create Reasons

The response is of type object.