Description

The verb update should be used to describe that a property on a resource has changed. For example: Monica updated her street address to 234 Amazing St.

To be useful in data synchronization, an update activity should describe the name of the property which has changed and provide the new value inside the object construct.

When new items are added to an existing list the verb to use is post and a target is expected to denote the destination.

Spec section: http://activitystrea.ms/head/activity-schema.html#update

Properties

• "change" should be added as a property to the activity construct. Change is an object which has 2 proprties:
• "name": The name of the property suitable for human consumption
• "value": The new value for the field which changed. This can be a reference to the object. For references dot notation can be used to refer to other properties. For details see http://tools.ietf.org/html/draft-zyp-json-schema-02#section-6.2.1. 

URI

http://activitystrea.ms/schema/1.0/update 

Examples

{

"change" : 

  {"name" : "street address"},

  {"value" : "234 Amazing St"

}

OR

{

"change" : 

  {"name" : "street address"},

  {"value" : {"$ref": #object.streetAddress}

}

Notes

Other verbs to use for data synchronization are: post and delete

Implementations

Facebook is researching using the update verb to send real-time notifications of changes to profile data.

Others ?

Maintainers

Monica Wilkinson