osapi.jive.corev3.inbox.InboxEntry

An InboxEntry is an activity in a person's Inbox. The jive.read field denotes whether or not this entry has been read. An example JSON representation looks like this:

Example JSON:
 {
    "published":"2012-12-28T19:12:09.586+0000",
    "title":"some document",
    "updated":"2012-12-28T19:12:08.840+0000",
    "url":"http://example.jiveon.com/docs/DOC-1001",
    "verb":"jive:created",
    "actor":{
       "id":"http://example.jiveon.com/api/core/v3/people/1",
       "displayName":"Administrator",
       "image":{
          "url":"http://example.jiveon.com/api/core/v3/people/1/avatar"
       },
       "objectType":"jive:person",
       "published":"2012-12-28T18:26:08.246+0000",
       "updated":"2013-01-09T16:31:10.028+0000",
       "url":"http://example.jiveon.com/people/admin"
    },
    "content":"<a href=\"http://example.jiveon.com/people/admin\">Administrator</a> created <a href=\"http://example.jiveon.com/docs/DOC-1001\">some document</a>",
    "jive":{
       "collection":"102-1001",
       "collectionUpdated":"2012-12-28T19:12:40.535+0000",
       "read":true,
       "replyCount":1,
       "update":"http://example.jiveon.com/api/core/v3/contents/1008/read"
    },
    "object":{
       "id":"http://example.jiveon.com/api/core/v3/contents/1008",
       "displayName":"some document",
       "objectType":"jive:document",
       "published":"2012-12-28T19:12:08.828+0000",
       "summary":"Expense report for December 2012",
       "updated":"2012-12-28T19:12:08.840+0000",
       "url":"http://example.jiveon.com/docs/DOC-1001"
    },
    "provider":{
       "displayName":"Jive",
       "objectType":"jive:instance",
       "url":"http://example.jiveon.com"
    }
 }
Example:

Note that, although Inbox Entries look like activities, there is no direct way to create them through Activity Stream related APIs. Instead, the entries are created as a side effect of creating a Share or DirectMessage that includes the recipient, or being @mentioned in a content object.

Properties

PropertyTypeMode Description
actorObjectread-only

The person (or other object) that created this activity.

contentStringrequired

Text (or possibly HTML) content describing this activity.

generatorObjectread-only

The application used to generate this activity.

iconMediaLinkoptional

An icon associated with this activity.

idStringread-only

Internal identifier for this activity.

jiveJiveExtensionoptional

Jive extensions to the standard Activity Streams format.

objectObjectoptional

The object that was affected by this activity.

openSocialOpenSocialoptional

OpenSocial extensions to the standard Activity Streams format.

providerObjectread-only

The service instance at which this activity was generated.

publishedISO 8601 Dateread-only

The date and time at which this activity was generated.

targetObjectoptional

The object representing the "context" or "target" of this activity.

titleStringrequired

The title of this activity.

updatedISO 8601 Dateread-only

The date and time at which this activity was most recently updated.

urlStringoptional

A URL pointing at more detailed information related to this activity.

verbStringoptional

The verb describing the category of activity that took place. Verbs for Jive standard actions will be prefixed with jive:.

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

Methods

toURI()

Retrieves

String

Description

Retrieves:
  • A URI representing this entity, or undefined if no such URI exists.