POST Moderate chat

Moderator Apply Decision to Flagged User

If a user is reported by other users as being abusive, the user will be sent to the moderation queue and is flagged while in the queue.

POST /api/v3/{appid}/chat/rooms/{roomid}/moderation/flaggedusers/{userid}/applydecision

If a user is reported by other users as being abusive, the user will be sent to the moderation queue and is flagged while in the queue.

Invoke this method to either approve or reject the user
In either case the user is no longer flagged
In either case the reports are erased
If apply is true, user gets shadowban effect with no expiration
If apply is false, flag is remove

BODY PROPERTIES

approve : (required) Pass true to approve the user (indicate the user is not abusive) or false to reject the user.

Request

Parameters

Values in the path and query string.

appid path

string TalkLabs ID required

The TalkLabs application ID assigned to your account.

Example: your-app-id

roomid path

string TalkLabs ID required

The TalkLabs assigned room ID returned when the room was created.

Example: room-id

userid path

string customer-defined required

The customer defined user ID from your application or identity system.

Example: u-8842

Request

JSON body

Send as application/json.

approve

boolean required

Request example

{
  "approve": true
}

Response

Status codes

Every JSON response uses the API result envelope.

200 OK ApiResult

400 Bad Request ApiResult

403 Forbidden ApiResult

404 Not Found ApiResult

500 Internal Server Error ApiResult

curl --request POST \
  --url "https://api.sportstalk247.com/api/v3/${APP_ID}/chat/rooms/${ROOM_ID}/moderation/flaggedusers/${USER_ID}/applydecision" \
  --header "Accept: application/json" \
  --header "x-api-token: ${TALKLABS_API_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "approve": true
}'

const appId = process.env.TALKLABS_APP_ID;
const roomid = 'room-id';
const userid = 'u-8842';

const response = await fetch(
  `https://api.sportstalk247.com/api/v3/${appId}/chat/rooms/${roomid}/moderation/flaggedusers/${userid}/applydecision`,
{
  method: 'POST',
  headers: {
    Accept: 'application/json',
    'x-api-token': process.env.TALKLABS_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "approve": true
}),
});

const result = await response.json();

import json
import os
import requests

app_id = os.environ["TALKLABS_APP_ID"]
roomid = "room-id"
userid = "u-8842"

response = requests.post(
    f"https://api.sportstalk247.com/api/v3/{app_id}/chat/rooms/{roomid}/moderation/flaggedusers/{userid}/applydecision",
    headers={
        "Accept": "application/json",
        "x-api-token": os.environ["TALKLABS_API_TOKEN"],
    },
    json=json.loads(r'''{
  "approve": true
}'''),
)
response.raise_for_status()
result = response.json()

Environment variables TALKLABS_APP_ID TALKLABS_API_TOKEN

Response