Synology PhotoStation REST API

Version 0.2.0

An Unofficial Reference

SYNO.PhotoStation.File uploadphoto

Upload a photo file (and optional thumbnails) to an album within PhotoStation.


Parameter Description Required?
dest_folder_path Destination folder on PhotoStation (relative to root album) Yes
duplicate Defines how to handle duplicate files. Must be one of: ignore, rename or overwrite Yes
filename Destination filename (see Notes below) Yes
mtime Modification time (UNIX timestamp) Yes

In addition the file being uploaded must be sent via HTTP POST method with form name original. Other forms of the same photo can be uploaded at the same time (eg. thumbnails) provided they are identified by one of the following form names in the request:

  • thumb_small (FILE_THUMB_M)
  • thumb_large (FILE_THUMB_XL)

Sample Request

curl -b PHPSESSID=xxx \
     -F 'original=@/path/to/original/file' \
     -F 'thumb_small=@/path/to/small/thumb' \
     -F 'thumb_large=@/path/to/large/thumb' \

Sample Response



  • The destination filename (filename) must end in a supported file extension:
Type Extension
Photo ‘jpg’, ‘jpeg’, ‘jpe’, ‘bmp’, ‘gif’, ‘png’, ‘tiff’, ‘tif’
Photo (raw) (Sony) arw, srf, sr2
Photo (raw) (Kodak) dcr, k25, kdc
Photo (raw) (Canon) cr2,crw
Photo (raw) (Nikon) nef
Photo (raw) (Minolta) mrw
Photo (raw) (Pentax) ptx, pef
Photo (raw) (Fuji) raf
Photo (raw) (Hasselblad) 3fr
Photo (raw) (Epson) erf
Photo (raw) (Mamiya) mef
Photo (raw) (Leaf) mos
Photo (raw) (Olympus) orf
Photo (raw) (Panasonic) rw2
Photo (raw) (Adobe Digital Negative) dng
Photo (raw) (Sigma Raw Image) x3f
Photo (raw) (Panasonic) raw
Video mpg, mpeg, avi, wmv, asf, mov, flv, f4v, 3gp, 3g2, mp4, m4v, qt, divx, xvid, dat, m2ts, m2t, mts