SYNO.PhotoStation.Album edit
Edit the metadata or settings for an album.
Request
| Parameter | Description | Required? |
|---|---|---|
| id | ID of album | Yes |
| allow_comment | Allow comments (only allowed for first level albums) | Optional |
| conversion | Unknown. Enabled by default, can only disable in first level albums | Optional |
| description | Description of album | Optional |
| inheritParent | (boolean) | Optional |
| name | Name of album | Optional |
| sort_by | Sorting method for album. One of filename, takendate, createdate, preference or default |
Optional |
| sort_direction | One of asc or desc |
Optional |
| title | Title to assign to album | Optional |
| type | One of public, private or password |
Optional |
| watermark_path | Path to watermark file | Optional * |
| watermark_opacity | Opacity of watermark | Optional * |
| watermark_gravity | Gravity of watermark file | Optional * |
| watermark_size | Size of watermark file | Optional * |
In order to apply a watermark, all four watermark_* parameters must be present.
If setting type to password, one must include a password parameter and
value as well.
Sample Response
{
"success": true
}
Errors
On error, edit can return one of the following error values:
| Error Value | Description |
|---|---|
WEBAPI_ERR_BAD_REQUEST |
Missing or invalid parameter(s) |
PHOTOSTATION_ALBUM_EDIT_FAIL |
General error during album update |
PHOTOSTATION_ALBUM_NO_MANAGE_RIGHT |
User does not have manage rights for album |
PHOTOSTATION_ALBUM_NOT_ADMIN |
Admin user required for some settings (title, sort_by, sort_direction, allow_comment, type, password, conversion) |