Modifying Objects

To modify a Zenfolio object, you need to construct a matching updater object and pass it to the corresponding API method. Not all objects can be modified through the API. Currently, modifications are allowed to the following objects:

When submitting an updater object, you only need to specify those fields that you want to change. For example, if you need to change a gallery caption, you only need to provide the Caption field in the PhotoSetUpdater object. Other fields can be omitted or can be set to null.

Updater methods usually return the snapshot of the updated object. For example, UpdatePhoto returns a Photo snapshot that reflects the changes applied to the photo object.

Note that only the object owner is allowed to update the object. That means that your application needs to authenticate the user and supply the authentication token in the request to an updater method. See the Authentication chapter for more details.