Action

An Action is an Activity directed towards specific users. Actions show up in a user's Actions stream on their home page. When created via this API, an action will be an App Action, and the icon for the app will be displayed next to the action.

Example:
Create Action

The JSON for an Action is the same as an Activity with the "openSocial" and "deliverTo" fields present. POST to /api/core/v3/activities to generate a new action. See Sending Actions for more information on creating actions. The minimum set of fields you must include are the following, where the "deliverTo" field has a valid list of Person URI's.

 {
    "title": "Simple activity title",
    "content": "See this activity!",
    "openSocial" : {
        "deliverTo" : [
            "https://example.jiveon.com/api/core/v3/people/1234",
            "https://example.jiveon.com/api/core/v3/people/1235"
        ]
    }
 }

Fields

FieldTypeMode Description
actionsActionEntry[]read-only

Set of user actions that can be taken in response to this action notification.

bodyStringread-only

HTML body text of this inbox entry.

entryStateStringread-only

Current state of this inbox entry. Valid values are:

  • awaiting_action
  • accepted
  • rejected
  • ignored
  • hidden
  • user_action_1 - First app defined action was performed
  • user_action_2 - Second app defined action was performed
  • user_action_3 - Third app defined action was performed
  • user_action_4 - Fourth app defined action was performed
  • user_action_5 - Fifth app defined action was performed
entrySubtypeStringread-only

Specialized subtype for notification entries.

entryTypeStringread-only

Type of this inbox entry. Valid values are:

  • notification - Notification from Jive or a Jive App.
  • action - Action request from a Jive App.
idStringread-only

Unique (within Jive instance) identifier of this inbox entry.

propertiesObjectread-only

General purpose properties associated with this inbox entry.

publishedISO 8601 Dateread-only

Date and time this inbox entry was originally created.

requestMessageStringread-only

HTML message sent in this inbox entry.

resourcesObjectread-only

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

summaryStringread-only

Summary of this inbox entry.

targetObjectread-only

Target Jive object for this inbox entry.

titleStringread-only

Title of this inbox entry.

typeStringread-only

The object type of this object ("action").

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