Copy File - Openinary Docs

Duplicates a file inside its own folder. The endpoint takes no request body, and there is no way to copy into a different folder in one call: copy the file, then move it.

POST /storage/{path}/copy

curl -X POST http://localhost:3000/storage/photos/portrait.jpg/copy \
  -H "Authorization: Bearer <api_key>"

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

Only files can be copied. A folder path returns 404, so copy a folder’s files one by one. Auth: API key required. A dashboard session cookie also works.

Path parameters

Param	Type	Required	Description
`path`	string	yes	Path to the file relative to the storage root, e.g. `photos/portrait.jpg`. Use the `path` of a file returned by List Storage.

Response

Field	Type	Description
`success`	boolean	`true` if the copy succeeded
`path`	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

Code	Meaning
`200`	Copy created
`400`	Path is missing
`404`	File not found, or the path is a folder
`500`	Storage backend failed to copy

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.