AbuseReport

An Abuse Report contains information about abuse reports. An abuse report is automatically created when content is marked as abusive. These reports can be viewed and moderated by moderators and system administrators. Moderation and abuse settings are managed by an administrator using the Admin Console. Refer to Moderation Entity for information about the moderation process. Refer to Content Service for endpoints related to creating and viewing abuse reports associated with a piece of content.

Refer to the Abuse Report Service for a list of all related endpoints.

Examples:
Create Abuse Report
To create an abuse report for a piece of content, perform a POST to /api/core/v3/contents/123/abuseReports where "123" is the ID for the content item. A sample set of fields included in the JSON payload:
 {
     type: "abuseReport",
     message: "Content is not appropriate",
     category: "General Abuse"
 }

This example can be expressed using cURL:

curl -X POST -u USER -H "Content-Type: application/json" --data '{ type: "abuseReport", message: "Content is not appropriate", category: "General Abuse" }' http://example.jiveon.com/api/core/v3/contents/123/abuseReports
Get All Abuse Reports for Content
To get the abuse reports for a piece of content, perform a GET to /api/core/v3/contents/123/abuseReports where "123" is the ID for the content item. A sample response:
 "list" : [
     {
         "id": "321",
         "resources": {
             "self": {
                 "allowed": ["GET"],
                 "ref": "https://example.jiveon.com/api/core/v3/abuseReports/321"
             }
         },
         "object": "https://example.jiveon.com/api/core/v3/contents/123",
         "published": "2012-07-20T17:28:36.304+0000",
         "message": "Language does not look ok",
         "category": "General Abuse",
         "author": {
             "id": "2002",
             "resources" : {

                 ...

                 "self": {
                     "allowed": ["GET", "DELETE", "PUT"],
                     "ref": "https://example.jiveon.com/api/core/v3/people/2002"
                 },

                 ...

             },
             "followerCount" : 437,
             "published" : "2015-04-07T18:44:54.482+0000",
             "updated" : "2015-05-08T17:23:57.753+0000",
             "displayName": "Jane Doe",

             ...

         },
         "type" : "abuseReport"
     },
         "id": "322",
         "resources": {
             "self": {
                 "allowed": ["GET"],
                 "ref": "https://example.jiveon.com/api/core/v3/abuseReports/322"
             }
         }
         "object": "https://example.jiveon.com/api/core/v3/contents/123",
         "published": "2012-07-20T17:28:36.304+0000",
         "message": "Slanderous remarks",
         "category": "Slander",
         "author": {
             "id": "2003",
             "resources" : {

                 ...

                 "self": {
                     "allowed": ["GET", "DELETE", "PUT"],
                     "ref": "https://example.jiveon.com/api/core/v3/people/2003"
                 },

                 ...

             },
             "followerCount" : 437,
             "published" : "2015-04-09T18:44:54.482+0000",
             "updated" : "2015-05-09T17:23:57.753+0000",
             "displayName": "John Doe",

             ...

         },
         "type" : "abuseReport"
     }
 ]
Get One Abuse Report
To get a specific abuse report, perform a GET to /api/core/v3/abuseReports/321 where "321" is the ID for the abuse report item. A sample response:
 {
     "id": "321",
     "resources": {
         "self": {
             "ref": "https://example.jiveon.com/api/core/v3/abuseReports/321",
             "allowed": ["GET"]
         }
     },
     "object": "https://example.jiveon.com/api/core/v3/contents/1106",
     "published": "2012-07-20T17:28:36.304+0000",
     "message": "Language does not look ok",
     "category": "Explicit Content",
     "author": {
         "id": "2002",
         "resources": {

             ...

             "self": {
                 "allowed": ["GET", "DELETE", "PUT"],
                 "ref": "https://example.jiveon.com/api/core/v3/people/2002"
             },

             ...

         },
         "followerCount" : 437,
         "published" : "2015-04-07T18:44:54.482+0000",
         "updated" : "2015-05-08T17:23:57.753+0000",
         "displayName": "Jane Doe",

         ...

     },
     "type" : "abuseReport"
 }
Moderate Abuse Report
To moderate an abuse report, perform a PUT to /api/core/v3/moderation/123 where "123" is the ID for the abuse report. A sample set of fields included in the JSON payload:
 {
     "id": "1002",
     "message": "Content deemed inappropriate",
     "resolution": "rejected"
 }

This example can be expressed using cURL:

curl -X PUT -u USER -H "Content-Type: application/json" --data '{ "id": "1002", "message": "Content deemed inappropriate", "resolution": "rejected" }' http://example.jiveon.com/api/core/v3/moderation/123
Since: 3.12

Fields

FieldTypeMode Description
authorPersonread-only

Person that flagged the content.

categoryStringrequired

The category for the type of abuse. Possible values are:

  • General Abuse
  • Profanity
  • Explicit Content
  • Impersonation
  • Harassment
  • Slander
  • Racial Abuse
  • Religious Abuse
  • Spam
  • Private Information
idStringread-only

Identifier (unique within an object type and Jive instance) of this object.

messageStringrequired

Explanation provided by the reporter for why the content was flagged.

objectStringread-only

URI of the content being flagged for abuse.

publishedISO 8601 Dateread-only

Date and time for when this content was originally flagged.

resourcesObjectread-only

Resource links (and related permissions for the requesting person) relevant to this object.

typeStringrequired

The type of report. This field will always be abuseReport.

→ Fields used by update and create operations
→ Fields used only by create operations
→ Fields not used by update or create operations