Documentation

Move, copy, change visibility, delete, and manage trash.

Move / Rename

PUT /move

{ "source_path": "documents/old.pdf", "destination_path": "archive/old.pdf" }

POST /duplicate - returns 201 with an array of created items.

{ "item_path": "documents/report.pdf" }

Duplicated files reference the same underlying storage object (r2_key).

POST /copy-folder

{
  "source_folder_path": "projects/template",
  "destination_folder_path": "projects/copy"
}

PUT /privacy

{ "item_path": "documents/report.pdf", "visibility": "PRIVATE" }

Accepted values: PRIVATE, PUBLIC, SHARED.

PRIVATE and PUBLIC update stored visibility. SHARED is normally derived when you grant permissions via File Sharing.

DELETE /{item_path} - e.g. https://cloud.storra.host/api/v1/client/documents/report.pdf.

Returns 204. If trash is enabled on your account (default), items are soft-deleted. Otherwise they are permanently removed.

GET /trash - list trashed items (skip, limit query params, max limit 500).

POST /trash/restore - body: {"item_ids": ["file_550e8400", "folder_abc123"]}

POST /trash/empty - permanently delete all trashed items.

Trashed items expire after 30 days (expires_at on list response).