Activity

An Activity represents an event that has occurred within a Jive instance. Activities are presented in the format defined by the OpenSocial Specification, which in turn extends the Activity Streams 1.0 specification. Activities are used for several different purposes within the Core API, which are described in more detail in Activity Use Cases.

Note that activities are not first-class objects and do not have URIs, so instead the URL of the object of the activity is given. In the following example, the "object" field is a document that was created.

Examples:

Example JSON

{
   "url":"http://company.jive.com/docs/DOC-2131",
   "title":"A test document",
   "verb":"jive:created",
   "updated":"2012-09-28T15:35:20.761+0000",
   "content":"<a href=\"http://company.jive.com/people/fred\">Fred Flintstone</a> created <a href=\"http://company.jive.com/docs/DOC-2131\">A test document</a>",
   "object":{
     "displayName":"A test document",
     "objectType":"jive:document",
     "url":"http://company.jive.com/docs/DOC-2131",
     "summary":"Test document text",
   },
   "actor":{
      "displayName":"Fred Flintstone",
      "objectType":"jive:person",
      "url":"http://company.jive.com/people/fred"
   }
}

Create Activity

POST to /api/core/v3/activities to generate a new activity. See the activities service for more information. The minimum set of fields you must include are:

 {
  "title": "Simple activity title",
  "content": "See this activity!"
 }

Fields

Field	Type	Mode †	Description
`actor`	`PersonActivityObject`	read-only	The person (or other object) that created this activity.
`content`	`String`	required	Text (or possibly HTML) content describing this activity.
`generator`	`ActivityObject`	read-only	The application used to generate this activity.
`icon`	`MediaLink`	optional	An icon associated with this activity.
`id`	`String`	read-only	Internal identifier for this activity.
`jive`	`JiveExtension`	optional	Jive extensions to the standard Activity Streams format.
`object`	`ActivityObject`	optional	The object that was affected by this activity.
`openSocial`	`OpenSocial`	optional	OpenSocial extensions to the standard Activity Streams format.
`previewImage`	`MediaLink`	read-only	An icon associated with this activity.
`provider`	`ActivityObject`	read-only	The service instance at which this activity was generated.
`published`	`ISO 8601 Date`	read-only	The date and time at which this activity was generated.
`target`	`ActivityObject`	optional	The object representing the "context" or "target" of this activity.
`title`	`String`	required	The title of this activity.
`type`	`String`	read-only	The object type ("activity").
`updated`	`ISO 8601 Date`	read-only	The date and time at which this activity was most recently updated.
`url`	`String`	optional	A URL pointing at more detailed information related to this activity.
`verb`	`String`	optional	The verb describing the category of activity that took place. Verbs for Jive standard actions are prefixed with `jive:` and are for internal use by Jive. Possible values include: jive:applied - used when content is shared, tagged, and for other general purpose activity jive:commented - added a comment jive:correct_answer_set - answer marked as correct answer jive:created - created something jive:helped - something marked as helpful jive:liked - something was liked jive:outcome_set - an outcome was applied jive:replied - replied to a discussion jive:voted - voted in a poll