Skip to main content

Endpoint

Auth: API key required. A dashboard session cookie also works.
A copy always lands in the source file’s own folder. This endpoint takes no request body, and there is no way to copy into a different folder in one call. To place a duplicate elsewhere, copy it and then move it.
Only files can be copied. A folder path returns 404. To copy a folder, copy its files one by one.

Path parameters

string
required
Path to the file relative to the storage root. Use the path of a file returned by List Storage.photo.jpg · photos/portrait.jpg

Response

boolean
true if the copy succeeded.
string
Path of the new copy. The name is the source name with copy appended before the extension. If that name is taken, a counter is added: portrait copy.jpg, then portrait copy (1).jpg, portrait copy (2).jpg, and so on.
Status codes:

Example

Move File or Folder

Move instead of duplicating, and the one endpoint that does take a destination.

List Storage

Browse folders and files one level at a time.