Stream

A custom activity stream definition for a person. See the StreamEntry class.

Examples:
Example JSON

JSON including important fields and a Stream's resources. See the tables below for a list of all fields and resources.

{
  "type" : "stream",
  "name" : "Personal Stream",
  "person" : {
    "name" : {
      "formatted" : "Administrator"
    },
    "type" : "person",
    "displayName" : "Administrator",
    "id" : "1"
  },
  "source" : "custom",
  "receiveEmails" : false,
  "published" : "2012-07-13T22:27:07.331+0000",
  "updated" : "2012-07-13T22:27:07.331+0000",
  "id" : "14",
  "resources" : {
    "associations" : {
      "ref" : "https://example.jiveon.com/api/core/v3/streams/14/associations",
      "allowed" : [ "POST", "GET", "DELETE" ]
    },
    "self" : {
      "ref" : "https://example.jiveon.com/api/core/v3/streams/14",
      "allowed" : [ "GET", "DELETE", "PUT" ]
    },
    "html" : {
      "ref" : "https://example.jiveon.com/activity?streamSource=custom&streamID=14",
      "allowed" : [ "GET" ]
    },
    "activity" : {
      "ref" : "https://example.jiveon.com/api/core/v3/streams/14/activities",
      "allowed" : [ "GET" ]
    }
  }
 }

To create a new custom stream, perform a POST to /people/{personID}/streams. See the Person Service and Stream Service. The minimum JSON required to create a new Stream: 

{
  "name" : "Employee cat pics",
  "source" : "custom"
}

CURL command to create a new stream:

curl -u jane.employee:password -H "Content-Type: application/json" --data '{ "name": "Employee cat pics", "source": "custom"}' http://example.jiveon.com/api/core/v3/people/1234/streams

Fields

FieldTypeMode †Description
idStringread-only

Unique identifier of this custom stream.

nameStringrequired

Name of this custom stream. Will be a zero length string on custom streams with a source other than custom. Must be unique (per user) for streams with source custom.

personPersonread-only

A Person describing the person that owns this custom stream.

publishedISO 8601 Dateread-only

Date and time this custom stream was originally created.

receiveEmailsBooleanoptional

Flag indicating whether the owner of this custom stream wants to receive email when new activity arrives.

resourcesObjectread-only

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

sourceStringrequired

Source of this particular stream. Custom streams managed via this API MUST have a stream source of custom. Other values for non-custom streams are:

  • all - the standard "Activities" stream
  • communications - the standard "Communications" stream
  • connections - the standard "Connections" stream
  • context - TODO definition
  • profile - TODO definition
  • watches - TODO definition
typeStringread-only

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

updatedISO 8601 Dateread-only

Date and time this custom stream configuration was most recently updated.

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

Resources

ResourceMethodDescription
activityGET

Return a paginated list of activities for the specified stream.

Retrieves:
  • Activity[]
    • associationsGET

    Return a paginated list of Objects for Jive objects that are associated with the specified stream, and match the optionally specified filters.

    The following filter expressions are supported by this service:

    • type(xxx) - Filter by object type(s), where xxx is a comma delimited list of the object types you want returned (document, group, etc.)
    Retrieves:
  • Object[]
    • associationsPOST

    Add associations between the specified custom stream and the list of specified Jive objects. This is an all or nothing operation; if any individual attempt to associate fails, all previously successful attempts will be rolled back.

    Takes:
    • objectURIs the object URIs of the objects to be associated
    associationsDELETE

    Remove an association between the specified custom stream and the specified Jive object.

    htmlGET

    Return the HTML representation of this stream.

    selfGET

    Return an updated version of this stream.

    Retrieves:
  • Stream representing the updated stream
    • selfPUT

    Update the information about this stream.

    Retrieves:
  • Stream representing the updated stream
    • selfDELETE

    Delete this stream.