Skip to main content

​
Endpoint

POST /storage/{path}/move
Auth: API Key required

​
Path parameters

​
path
string
required
Path to the file or folder relative to the storage root. Use the id from List Storage.photo.jpg · photos/portrait.jpg · photos

​
Body parameters

​
destination
string
Path to the destination folder, relative to the storage root. Omit or leave empty to move to the root.archive · photos/2024

​
Response

{
  "success": true,
  "path": "archive/portrait.jpg"
}
​
success
boolean
true if the move succeeded.
​
path
string
The new full path of the file or folder.
Status codes: 200 success · 400 already in that folder · 404 not found · 500 error
There is no bulk/batch move endpoint. To move multiple items, call this endpoint once per file or folder.

​
Example

curl -X POST http://localhost:3000/storage/photos/portrait.jpg/move \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{"destination": "archive"}'

Copy File

Duplicate a file into a different folder.

List Folders

Get every folder path, useful for building a “Move to” picker.