Save a new set of extended properties for a external stream instance with specified name/value pairs, and return an entity representing the newly created extended properties. Any previous extended properties for this external stream instance will be completely replaced.

This service only accepts oAuth authentication. Assuming that the oAuth token used to access this service was acquired through 2-legged oAuth, the properties being stored on the target external stream instance will be also associated with the consumer of the oAuth token.

Path Parameters:

Takes:

Retrieves:

Return Status:

Save a new set of extended properties for a external stream instance with specified characteristics, and return an entity representing the newly created extended properties. Any previous extended properties for this external stream instance will be completely replaced.

This service only accepts oAuth authentication. Assuming that the oAuth token used to access this service was acquired through 2-legged oAuth, this service will validate that the consumer of the oAuth token can access the specified add-on.

Path Parameters:

Takes:

Retrieves:

Return Status:

Since: 3.9

Save a new set of private properties for a external stream instance with specified name/value pairs, and return an entity representing the newly created private properties. Private properties are scoped to the viewer and are not visible to nor do they overlap with any other user. Any previous private properties for this external stream instance will be completely replaced.

This service only accepts oAuth authentication. Assuming that the oAuth token used to access this service was acquired through 2-legged oAuth, the properties being created on the target external stream instance will be those associated with the consumer of the oAuth token.

Path Parameters:

Takes:

Retrieves:

Return Status:

Since: 3.10

Delete the existing extended properties for the specified external stream instance.

This service only accepts oAuth authentication. Assuming that the oAuth token used to access this service was acquired through 2-legged oAuth, the properties being deleted from the target external stream instance will be also associated with the consumer of the oAuth token.

Path Parameters:

Return Status:

Delete the existing extended properties for the specified external stream instance.

This service only accepts oAuth authentication. Assuming that the oAuth token used to access this service was acquired through 2-legged oAuth, this service will validate that the consumer of the oAuth token can access the specified add-on.

Path Parameters:

Return Status:

Since: 3.9

Delete the existing private properties for the specified external stream instance.

This service only accepts oAuth authentication. Assuming that the oAuth token used to access this service was acquired through 2-legged oAuth, the properties being deleted from the target external stream instance will be those associated with the consumer of the oAuth token.

Path Parameters:

Return Status:

Since: 3.10

Return the specified extended properties for the specified external stream instance.

This service only accepts oAuth authentication. Assuming that the oAuth token used to access this service was acquired through 2-legged oAuth, the properties being deleted from the target external stream instance will be also associated with the consumer of the oAuth token.

Path Parameters:

Retrieves:

Return Status:

Return the specified extended properties for the specified external stream instance.

This service only accepts oAuth authentication. Assuming that the oAuth token used to access this service was acquired through 2-legged oAuth, this service will validate that the consumer of the oAuth token can access the specified add-on.

Path Parameters:

Retrieves:

Return Status:

Since: 3.9

Return the specified external stream instance with the specified fields.

Path Parameters:

Query Parameters:

Retrieves:

Return Status:

Return the specified external stream instance with the specified fields.

Path Parameters:

Query Parameters:

Retrieves:

Return Status:

Return a paginated list of external stream instances that match the specified filter criteria.

This service supports the following filters. Parameters, when used, should be wrapped in parentheses, and multiple values separated by commas. See the examples for clarification.

This service supports the following sort types.

Query Parameters:

Takes:

Retrieves:

Return Status:

Return the private properties for the specified external stream instance. Private properties are scoped to the viewer and are not visible to nor do they overlap with any other user.

This service only accepts oAuth authentication. Assuming that the oAuth token used to access this service was acquired through 2-legged oAuth, the properties being created on the target external stream instance will be those associated with the consumer of the oAuth token.

Path Parameters:

Takes:

Retrieves:

Return Status:

Since: 3.10

Create a new external stream activity entity.

This service does not require authentication and can be used anonymously. The parameters extensionUUID, externalID, and privatePath are all available through the UI after installation.

When an AddOn is installed into Jive, contained ExternalStreamDefinition will be imported. Each ExternalStreamDefinition that supports this functionality for easily creating new external stream activities, will also include a transformation definition. These transformations are going to be used to convert the payload of this call into a format that can be understood by Jive. If the payload fails to be transformed into Jive's format, a Bad Request (error 400) will be returned.

Below is an example of a payload received by this service before it was converted

     {
          "entry": {
              "image": "http://external.crm/og/id/123.png",
              "title": "Acme Corp Opportunity",
              "description": "Selling to Acme Corp",
              "url": "http://external.crm/og/id/123"
          }
     }
 

  curl -i -X POST  -H "application/x-www-form-urlencoded"
                   -d "subject=Published a blog entry today"
                   -d "type=website update"
                   -d "url=http://URL_TO_MY_BLOG/2015/03/03/world/paris-skeletons-found/blog.html"
                       http://JIVE_INSTANCE/api/core/v3/extstreams/activities/external/xyz/123/abc
  

and this is the JSON format as understood by Jive after the transformation

   {
      "activity: {
          "action": {
              "name": "updated",                               // Optional: actionName          Max 127 characters
              "description": "Updated an opportunity",         // Optional: actionDescription   Max 255 characters
          },
          "actor": {
              "name": "John Smith",                            // Optional: attributionName     Max 127 characters
              "email": "john.smith@jivesoftware.com"           // Optional: attributionEmail    Max 127 characters
          },
          "object": {
              "type": "jive:opportunity",                      // Required: openGraphType       Max 127 characters
              "url": "http://external.crm/og/id/123",          // Required: externalURL         Max 1024 characters
              "image": "http://external.crm/og/id/123.png",    // Optional: imageURL            Max 1024 characters
              "title": "Acme Corp Opportunity",                // Required: subject             Max 255 characters
              "description": "Selling to Acme Corp"            // Optional
          }
      }
   }
 

For convenience, errors while pushing new activity can be seen from the UI when configuring the external stream instance. This will let community admins easily test things and troubleshoot problems without the need to look into logs or trace network calls.

Example:

  curl -i -X POST  -H "Content-Type: application/json"  -d
  '{"myActivity":
      {
          "subject": "Acme Corp Opportunity",
          "url": "http://URL_TO_MY_BLOG/2015/03/03/world/paris-skeletons-found/blog.html"
      }
  }'
  http://JIVE_INSTANCE/api/core/v3/extstreams/activities/external/xyz/123/abc
  

  curl -i -X POST  -H "application/x-www-form-urlencoded"
                   -d "subject=Published a blog entry today"
                   -d "type=website update"
                   -d "url=http://URL_TO_MY_BLOG/2015/03/03/world/paris-skeletons-found/blog.html"
                       http://JIVE_INSTANCE/api/core/v3/extstreams/activities/external/xyz/123/abc
  

  {"activity":
      {
          "action": {
              "name": "posted a blog"
          },
          "object": {
              "image": "http://www.nasa.gov/sites/default/themes/NASAPortal/images/nasa-logo.gif",
              "title": "Acme Corp Opportunity",
              "type": "website update",
              "url": "http://URL_TO_MY_BLOG/2015/03/03/world/paris-skeletons-found/blog.html"
          }
      }
  }
  

Path Parameters:

Retrieves:

Return Status:

Since: 3.11