POST Moderate users

Report User

URL Arguments userid : required The ID of the user who is being reported, URL ENCODED.

POST /api/v3/{appid}/user/users/{userid}/report

URL Arguments

userid : (required) The ID of the user who is being reported, URL ENCODED.

BODY Parameters

userid : (required) This is the application specific user ID of the user reporting the first user.
reporttype: (required) This is the classification of the reported post. It must be one of the below values (note that 'false' represents information considered false by the reporter:
- abuse
- spam
- selfharm
- hate
- violence
- harassment
- nudity
- illegal
- false
- other

RESPONSES:

Code	Meaning	Description
200	OK	Request completed successfully
404	Not Found	The specified user or application could not be found
409	Conflict	The request was rejected because user reporting is not enabled for the application.

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

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.

reportType

integer · int32 required

userId

string customer-defined required

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

Request example

{
  "reportType": {},
  "userId": "u-8842"
}

Response

Status codes

Every JSON response uses the API result envelope.

200 OK ApiResult

400 Bad Request ApiResult

403 Forbidden ApiResult

409 Conflict ApiResult

500 Internal Server Error ApiResult

curl --request POST \
  --url "https://api.sportstalk247.com/api/v3/${APP_ID}/user/users/${USER_ID}/report" \
  --header "Accept: application/json" \
  --header "x-api-token: ${TALKLABS_API_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "reportType": {},
  "userId": "u-8842"
}'

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

const response = await fetch(
  `https://api.sportstalk247.com/api/v3/${appId}/user/users/${userid}/report`,
{
  method: 'POST',
  headers: {
    Accept: 'application/json',
    'x-api-token': process.env.TALKLABS_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "reportType": {},
  "userId": "u-8842"
}),
});

const result = await response.json();

import json
import os
import requests

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

response = requests.post(
    f"https://api.sportstalk247.com/api/v3/{app_id}/user/users/{userid}/report",
    headers={
        "Accept": "application/json",
        "x-api-token": os.environ["TALKLABS_API_TOKEN"],
    },
    json=json.loads(r'''{
  "reportType": {},
  "userId": "u-8842"
}'''),
)
response.raise_for_status()
result = response.json()

Environment variables TALKLABS_APP_ID TALKLABS_API_TOKEN

Response