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

Field	Type	Mode †	Description
`author`	`Person`	read-only	Person that flagged the content.
`category`	`String`	required	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
`id`	`String`	read-only	Identifier (unique within an object type and Jive instance) of this object.
`message`	`String`	required	Explanation provided by the reporter for why the content was flagged.
`object`	`String`	read-only	URI of the content being flagged for abuse.
`published`	`ISO 8601 Date`	read-only	Date and time for when this content was originally flagged.
`resources`	`Object`	read-only	Resource links (and related permissions for the requesting person) relevant to this object.
`type`	`String`	required	The type of report. This field will always be `abuseReport`.