Create Reasons

Create custom CometChat moderation flag reasons with REST API for review categories shown when messages are flagged.

POST /moderation/reasons

Create Reasons

cURL

curl --request POST \
  --url https://{appId}.api-{region}.cometchat.io/v3/moderation/reasons \
  --header 'Content-Type: application/json' \
  --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
  }
}

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

Reason created successfully.

data · object

Show child attributes