GET Moderate users
List Users in Moderation Queue
limit : optional Defaults to 200.
This method requires authentication.
- limit: (optional) Defaults to 200. This limits how many users to return from the queue
- cursor: (optional) Provide cursor value to get the next page of results.
- filterModerationState: (optional) Filters for users in the specified moderation state.
- approved: Moderator approved the user
- rejected: Moderator rejected the user
- flagged: Enough users reported the user that it is in the flagged state and sent to moderation queue
- filterUserId: (optional) Exact match filter for UserID
- filterHandle: (optional) Substring match for Handle (case-insensitive)
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 limit query integer · int32
The maximum number of records to return.
Example:1 cursor query string
The cursor returned by the previous page.
filterModerationState query integer · int32
Example: [object Object] filterUserid query string customer-defined
filterHandle query string
Response
Status codes
Every JSON response uses the API result envelope.
200 OK ApiResult 400 Bad Request ApiResult 403 Forbidden ApiResult 500 Internal Server Error ApiResult Example response · 200
{
"message": "",
"errors": {},
"data": {
"kind": "list.comments",
"cursor": "5e9e65f138a285193496316b",
"more": false,
"conversation": null,
"comments": [
{
"kind": "comment.comment",
"id": "5e9e65f138a285193496316b",
"appid": "5e9389ed38a2b10794e271ee",
"conversationid": "my_conversation_id",
"commenttype": "comment",
"added": 1587439089,
"modified": 1587439089,
"userid": "u-8842",
"user": {
"kind": "app.user",
"userid": "u-8842",
"handle": "dave_m",
"handlelowercase": "georgew",
"displayname": "Dave M.",
"pictureurl": "https://example.com/users/u-8842s/photos/original/a9/c7/a6/44-1-george-washington-18-1549729902.jpg",
"profileurl": "https://example.com/users/u-8842shington",
"banned": false
},
"body": "Hello, World! This is a comment with international characters and emojis. Intl: äöüÄÖÜß | Emojis: 😂🤣❤😍😒",
"hashtags": [],
"customtype": "my-custom-type",
"customid": "/articles/2020-03-01/article1/something-very-important-happened",
"custompayload": "{ num : 0 }",
"customtags": [
"taga",
"tagb"
],
"customfield1": "/sample/userdefined1/emojis/😂🤣❤😍😒",
"customfield2": "/sample/userdefined2/intl/characters/äöüÄÖÜß",
"edited": false,
"deleted": false,
"parentid": "",
"hierarchy": [],
"mentions": [],
"reactions": [
{
"type": "like",
"count": 0,
"users": []
}
],
"likecount": 0,
"replycount": 0,
"votecount": 0,
"votescore": 0,
"votes": [],
"moderation": "flagged",
"active": false,
"reports": [
{
"userid": "u-8842",
"reason": "abuse"
}
]
}
]
}
}