Social - Share - Update - JSON

Owned by Craig Vitter (Unlicensed)
Last updated: Mar 11, 2013 by AlexI (Unlicensed)
1 min read
/social/share/update/json/{id}/{type}/{title}/{description}?json=<object-json> (GET)
/social/share/update/json/{id}/{type}/{title}/{description} (POST)

Update a document in the share collection. Note: Can be called via post or get.

A simple web-based utility is available  for performing many share management activities.

Note that updating a share unendorses it for all communities for which the logged-in user is not a moderator.

Authentication

Required, see Auth - Login.

There is one exception to needing to be the owner or an administrator - if a share is only currently shared with a single community (this means it must have been explicitly unshared from the personal community of the user who created it), then it can be modifed by any content publisher or community moderator for that community.

Arguments

id (required)
ID of share to update

type (required)
Type of share: dataset, query, etc.

title (required)
Arbitrary display title for the share

description (required)
Arbitrary display description for the share

json (required)
JSON object

Example

Method.Get
http://infinite.ikanow.com/api/share/update/json/id/type/title/description?json=%7B%22userid%22%3A%224f5e189ada7f00000000510f%22%2C%22settings%22%3A%7B%22maximized%22%3Afalse%2C%22lastTabOpen%22%3A1%7D%7D

Method.Post

Example using curl:

curl \-XPOST 'http://infinite.ikanow.com/api/share/update/json/id/type/title/description' \-d '{"userid":"4f5e189ada7f00000000510f","settings":{"maximized":false,"lastTabOpen":1}}'
Example Response
{
	response: {
		action: "Update Share"
		success: true
		message: "Share updated successfully."
		time: 10
	}
}