Moves one or more albums to a new parent album. All albums will be located to the same parent if successful.
|Comma separated list of Album IDs
|Destination parent album ID
|Duplicate album handing (
overwrite or any other value)
sharepath must be present but may be empty to indicate the root album.
duplicate is set to
overwrite, any existing albums with same name as a
source album will be overwritten. Any other value (eg.g
cause the albums with naming conflicts to be skipped (see below).
If any albums are skipped due to name conflict, the returned data object
will contain a
skip array containing the IDs of all albums that were
move command supports cancellation via the
In order for
cancel to stop the album(s) being moved, the
id parameter must match the move
id parameter exactly,
otherwise cancellation will not find a matching operation. This means if
one is moving multiple albums in a single request, all the album moves
must be cancelled (if desired) with a single request.
Also note that cancellation is best effort and does not ensure the album
will not have already been moved by the time the cancellation operation is
received. There is no undo operation but albums can be returned to original
location via a new
move can return one of the following error values:
|Missing or invalid parameters
|Invalid destination path for album
|User does not have upload rights to destination album
|One or more source albums are either the destination album or a parent of the destination album