Move File or Folder - Openinary Docs

Moves one file or folder into another folder. There is no bulk endpoint, so call it once per item.

POST /storage/{path}/move

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

Auth: API Key required

Parameters

Param	In	Type	Required	Description
`path`	path	string	yes	Path to the file or folder relative to the storage root, e.g. `photos/portrait.jpg`. Use the `path` from List Storage.
`destination`	body	string	no	Destination folder, relative to the storage root, e.g. `photos/2024`. Omit or leave empty to move to the root.

Response

{
  "success": true,
  "path": "archive/portrait.jpg"
}

Field	Type	Description
`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

Copy File

Duplicate a file into a different folder.

List Folders

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