JiveExtension

Jive extensions are additions to the standard activitystrea.ms JSON format for activity stream entries. It is optionally included as the jive field in an Activity.

Fields

FieldTypeMode Description
answerStringread-only

URI of the correct answer (if any), if this object is a discussion marked as a question.

Availability:

Only present if the object field contains a discussion marked as a question, with a message marked as the correct answer

Since: 3.2
canCommentBooleanread-only
canReplyBooleanread-only
collectionStringread-only

Identifier that groups several activities around the same topic. Activities within such a collection are ordered newest to oldest by activity date.

collectionReadBooleanread-only

Boolean indicating if the Acclaim collection is read or unread.

Availability:

Only present if the containing activity appears in the inbox as Acclaim, e.g. an activity with a verb field of "jive:liked".

Since: 3.2
collectionUpdatedISO 8601 Dateread-only

Date of latest activity of the identifier that groups several activities.

displayStringoptional

Value describing the grouping style to be applied to this activity stream entry. Valid values are:

  • update - Each activity is presented as a separate update (default value)
  • grouped - Activities are grouped by common generator (i.e. which app created this) and verb
  • digest - Specialized format (Jive internal use only)
helpfulString[]read-only

URIs of messages that have been marked "helpful", if object is a discussion that has been marked as a question.

Availability:

Only present if the object field contains a discussion that has been marked as a question, and there are one or more messages that have been marked as helpful

Since: 3.2
likeCountIntegerread-only

Number of people who have liked this object.

Availability:

Will be present only for object types that support being liked.

Since: 3.4
likedBooleanread-only

Flag indicating whether the requesting user has liked this object.

Availability:

Will be present only for object types that support being liked.

Since: 3.5
mentionedActivityObjectread-only

The object that was actually mentioned (typically a Person or a Place).

Availability:

Only present when this activity stream entry or inbox entry represents a mention (i.e. the verb field contains "jive.mentioned").

Since: 3.2
parentActivityObjectread-only

Parent content object for this comment or message.

Availability:

Only present on Jive creation activities related to comments or messages.

Since: 3.1
parentActorActivityObjectread-only

Actor who created the parent content object for this comment or message.

Availability:

Only present on Jive creation activities related to comments or messages

Since: 3.3
parentLikeCountIntegerread-only

Number of people who have liked the parent content object for this comment or message.

Availability:

Only present on Jive creation activities related to comments or messages

Since: 3.3
parentLikedBooleanread-only

Flag indicating whether the requesting user has liked the parent content object for this comment or message.

Availability:

Only present on Jive creation activities related to comments or messages

Since: 3.5
parentReplyCountIntegerread-only

Number of replies to the parent content object for this comment or message.

Availability:

Only present on Jive creation activities related to comments or messages

Since: 3.3
questionBooleanread-only

Flag indicating that this discussion is marked as a question, if object is a discussion.

Availability:

Only present if the object field contains a discussion.

Since: 3.2
readBooleanread-only

Flag indicating the inbox entry corresponding to this activity has been read.

Availability:

Only present on activities that correspond to inbox entries

replyCountIntegerread-only

The number of comments on or replies to the Jive object represented by the "object" field of the containing activity.

Availability:

Only present for supported content types, e.g. direct messages, updates, blog posts, and discussions.

resolvedStringread-only

If the object field contains a discussion marked as a question, this field will contain the resolution state ("open", "resolved", or "assumed_resolved").

Availability:

Only present when the object field contains a discussion marked as a question

stateStringread-only

Flag indicating the current state of an action. Valid values are:

  • awaiting_action
  • accepted
  • rejected
  • ignored
  • hidden
Availability:

Only present on activities that correspond to actions, when accessed via GET /actions (REST) or osapi.jive.corev3.actions.get() (JavaScript)

updateStringread-only

URI to update the read/unread state of the content object associated with this inbox entry. If the read field value is true, send a DELETE to this URI to mark it as unread. If the read field value is false, send a POST to this URI to mark it as read.

Availability:

Only present on activities that correspond to inbox entries

Since: 3.1
updateCollectionStringread-only

URI of the REST endpoint to mark the acclaim inbox entry as read or unread.

Availability:

Only present if the containing activity appears in the inbox as Acclaim, e.g. an activity with a verb field of "jive:liked".

Since: 3.2
→ Fields used by update and create operations
→ Fields used only by create operations
→ Fields not used by update or create operations