Move File or Folder

Endpoint

POST /storage/{path}/move

Auth: API Key required

Path parameters

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

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"
}

boolean

true if the move succeeded.

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.

Overview

Media

Files

Storage

Cache

Video Processing

API Keys

System

Endpoint

Path parameters

Body parameters

Response

Example

Copy File

List Folders

​Endpoint

​Path parameters

​Body parameters

​Response

​Example

​Related

Copy File

List Folders

Endpoint

Path parameters

Body parameters

Response

Example

Related