ExternalStreamInstance

An External Stream Instance represents a configured External Stream Definition that has been attached to a Purposeful Place. It also contains configuration information returned by the configuration UI.

 {
    "id":"1032",
    "config": {
        "configProp1":"abcd",
        "configProp2":"1234"
    },
    "definition":{
        //External stream definition JSON
       "type":"extStreamDefinition"
    },
    "parent":"http://example.jiveon.com/api/core/v3/places/1037",
    "state":"STAGED",
    "type":"externalStreamInstance",
    "published":"2013-01-25T20:03:08.702+0000",
    "updated":"2013-01-25T20:03:08.702+0000",
    "resources":{
       "self":{
          "allowed":[
             "POST",
             "GET"
          ],
          "ref":"http://example.jiveon.com/api/core/v3/extstreams/1032"
       }
    }
 }

Fields

Field	Type	Mode †	Description
`column`	`Integer`	optional	The column in which this instance is going to appear in the parent.
`config`	`Object`	optional	Configuration of this instance in JSON format. JSON format depends on the needs of each instance. When creating or updating this instance, it is possible to include an extra field forceResendRegistration of type boolean that indicates whether a registration notification should be sent to the external system or not.
`definition`	`ExternalStreamDefinition`	required	The definition type this instance belongs to.
`id`	`String`	read-only	Identifier (unique within an object type and Jive instance) of this object. This field is internal to Jive.
`lastRegister`	`ISO 8601 Date`	read-only	Date and time of the last time a registered notification was sent to the external system that is integrating with Jive.
`parent`	`String`	read-only	URI of the parent place of this instance.
`published`	`ISO 8601 Date`	read-only	Date and time this object was originally created.
`resources`	`Object`	read-only	Resource links (and related permissions for the requesting person) relevant to this object.
`state`	`String`	optional	State of this instance. Possible values are: STAGED - Not configured yet. Default value. VISIBLE - Configured and ready to be used
`status`	`Object`	read-only	Status of this instance when activity was published in JSON format.
`updated`	`ISO 8601 Date`	read-only	Date and time this object was most recently updated.

Resources

Resource	Method	Description
`privateprops`	`GET`	Retrieves private properties for this TileInstance
`privateprops`	`POST`	Updates private properties for this TileInstance
`self`	`GET`	Return an updated version of this external stream instance.