POST Moderate comments

Apply a comment moderation decision

If PRE MODERATION is enabled for a conversation, then all messages go to the queue before they can appear in the conversation.

POST /api/v3/{appid}/comment/moderation/queues/comments/{commentid}/applydecision

If PRE-MODERATION is enabled for a conversation, then all messages go to the queue before they can appear in the conversation. For each incomming message, a webhook will be fired, if one is configured.

If the conversation is set to use POST-MODERATION, messages will only be sent to the moderation queue if they are reported.

BODY PROPERTIES

approve : (required) Pass true to approve the comment or false to reject the comment.

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

commentid path

string TalkLabs ID required

The TalkLabs assigned comment ID.

Example: comment-id

Request

JSON body

Send as application/json.

approve

boolean required

Request example

{
  "approve": true
}

Request examples

Common variations

Historical examples filtered through the current request schema.

Approve Message in Queue

{
  "approve": true
}

Reject Message in Queue

This variation uses the endpoint and parameters described above.

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}/comment/moderation/queues/comments/${COMMENT_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 commentid = 'comment-id';

const response = await fetch(
  `https://api.sportstalk247.com/api/v3/${appId}/comment/moderation/queues/comments/${commentid}/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"]
commentid = "comment-id"

response = requests.post(
    f"https://api.sportstalk247.com/api/v3/{app_id}/comment/moderation/queues/comments/{commentid}/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