Storsum docs

How to set up your drive and use it every day, on the website and in the apps, and how to reach it from your own scripts.

On this page

Getting started
Using your drive
Storage
The apps
Your account
The API

Getting started

Create your account

Sign up on the website with your name, email and a password, or choose Sign up with Google and add Drive. Signing up with Google also connects that Google Drive straight away.

The phone and computer apps sign in with an email and password. If you signed up with Google, set a password in Settings on the website first.

Connect your storage

Open Storage and choose Connect storage, then pick a provider:

Google Drive, Box and pCloud open their own sign-in page; allow Storsum, and you are back.
Koofr asks for your Koofr email and an app password made in Koofr’s settings.
Cloudflare R2, Backblaze B2 and other S3 buckets ask for the bucket, an access key, and how much of the bucket Storsum may fill.

Each account adds its free space to your drive. Connect as many as you like, several of the same provider included. What each provider gives.

Upload your first files

On Files, choose Upload, pick your files, decide whether to encrypt them, and choose Upload. Each file goes to the account with the most room, unless you pick one under Store on. Progress shows in the corner while they upload.

Using your drive

Folders

New folder makes a folder where you are, with a name, a colour and an icon. Open a folder to work inside it: uploads and new folders go there, and the path above the title takes you back up. A folder’s menu (…) renames, moves, shares or deletes it.

Uploading

Encrypt these files? Yes, the default, scrambles them before they reach your storage. No stores them as they are, so you can also open them in the provider’s own app.
Store on is Automatic, following your upload rule, or one account you choose.
Drag and drop: drop files on the Files page on the website, or anywhere on the Windows and Linux app. Upload opens with them already picked.
On a phone you can pick from the gallery, choose files, or upload every photo taken between two dates.

Finding files

Search looks through file names. Filters (beside Files) narrow them by type, account, size and upload date. Switch between a list and a grid, and choose how big folder tiles are.

Opening and downloading

Open a file to preview it: photos, videos and PDFs show in place, and other files download or open in an app that can show them. Tick several files to download them together as one zip. A file’s Details show its size, account, date and whether it is encrypted.

Share link in a file’s menu makes a link anyone can open; Copy link copies it again later.
Invite someone shares a file or a whole folder with another Storsum user by email. It appears under Shared for them, to view and download.
Everything you share is listed on the Shared page, where you can stop a link or revoke an invite.

Trash

Move to trash sends files to Trash, and deleting a folder sends its files there too. In Trash, Restore brings them back and Delete for good removes them from your provider. Until then, nothing is removed at the provider.

Encryption, later

A file’s menu has Encrypt or Remove encryption. Storsum writes the new copy first and deletes the old one only once the new one is safely stored. You can do the same for several ticked files at once.

Moving between accounts

Move to another storage (in a file’s menu, or for several ticked files) moves files to another of your accounts without downloading anything. On Storage, Move all files empties one account into the others.

Google Drive

Sync picks up changes made directly in Google Drive. Import from Drive, once, makes Storsum show everything you own in your Drive, in Drive’s own folders; after that Sync keeps all of it up to date. Renaming a file in Storsum renames it in Drive, and deleting it for good from Trash deletes it from Drive too. Files you move to Storsum’s Trash stay there after a sync.

Storage

How full your drive is

Drive stats on Files shows free, used and total space across your accounts, with the pool bar in each account’s colour. Storage shows every account, how full it is, and what is using space. Check usage asks each provider again.

Where uploads go

On Storage, choose how uploads spread across your accounts:

Most room (the default): each file goes to the account with the most free space.
Take turns: files rotate across accounts, one after another.
In my order: fill the first account, then the next, in the order you set.

Reconnecting an account

If a provider stops accepting Storsum, for example after you change that account’s password, the account shows Reconnect. Until you reconnect it, uploads go to your other accounts.

Stopping using an account

Choose Move all files on that account to move its files to your other accounts, then Disconnect.

The apps

Everywhere, one drive

The website works in any modern browser, on a Mac, an iPhone and a Chromebook too. The apps for Windows 10 and 11, Linux and Android 8 or newer are on the Download page. Sign in with the same account and the same files are there.

Shortcuts

On the website, press ? for every keyboard shortcut: / searches, U uploads, N makes a folder, Delete moves the selected files to Trash.
In the Windows and Linux app, Esc or the mouse’s back button goes back: out of a folder, a search or a selection.

Your account

Settings

Your profile photo, and your password. Changing your password signs out every other device. The Privacy Policy and Terms of Service are there too.

Activity

What happened to your files and folders, newest first: uploads, moves, renames, shares and deletions.

API keys

Keys that let your own scripts and apps reach your drive. See the API below.

The API

Get a key

In the app, open API keys and choose Create key. The key is shown once; keep it somewhere safe. Send it with every request, to the base address https://storsum-api.onrender.com/api:

Authorization: Bearer storsum_…

What a key may do

Scope	Allows
`files:upload`	Upload files
`files:read`	List files and folders, read a file’s details, download it
`files:write`	Rename and move files; create, rename and move folders
`files:delete`	Move files and folders to Trash

New keys get all four. Keys made before November 2026 can only upload; make a new key for the rest.

Endpoints

Method	Path	Scope	What it does
POST	`/v1/uploads`	`files:upload`	Upload files (multipart)
GET	`/v1/files`	`files:read`	List files: `?folderId`, `?q`, `?kind`
GET	`/v1/files/{id}`	`files:read`	A file’s details
GET	`/v1/files/{id}/download`	`files:read`	Download a file, decrypted
PATCH	`/v1/files/{id}`	`files:write`	Rename or move a file
DELETE	`/v1/files/{id}`	`files:delete`	Move a file to Trash
GET	`/v1/folders`	`files:read`	List folders: `?parentId`, `?all=1`
POST	`/v1/folders`	`files:write`	Create a folder
PATCH	`/v1/folders/{id}`	`files:write`	Rename, recolour or move a folder
DELETE	`/v1/folders/{id}`	`files:delete`	Delete a folder (its files go to Trash)

Upload a file

curl -X POST "https://storsum-api.onrender.com/api/v1/uploads" \
  -H "Authorization: Bearer storsum_xxx" \
  -F 'filesMeta=[{"fieldName":"file-0","fileName":"hello.txt","mimeType":"text/plain","sizeBytes":"12"}]' \
  -F "file-0=@hello.txt;type=text/plain"

List, rename, download and delete

# List the files in a folder
curl "https://storsum-api.onrender.com/api/v1/files?folderId=FOLDER_ID" -H "Authorization: Bearer storsum_xxx"

# Rename a file and move it to the top of the drive
curl -X PATCH "https://storsum-api.onrender.com/api/v1/files/FILE_ID" \
  -H "Authorization: Bearer storsum_xxx" -H "Content-Type: application/json" \
  -d '{"name":"report-final.pdf","folderId":null}'

# Download it
curl -o report-final.pdf "https://storsum-api.onrender.com/api/v1/files/FILE_ID/download" -H "Authorization: Bearer storsum_xxx"

# Move it to Trash
curl -X DELETE "https://storsum-api.onrender.com/api/v1/files/FILE_ID" -H "Authorization: Bearer storsum_xxx"

Errors

Errors come back as JSON with a code and a message: API_KEY_REQUIRED or API_KEY_INVALID (401) for a missing, revoked or expired key, API_KEY_FORBIDDEN (403) when the key lacks the route’s scope, NOT_FOUND (404), and VALIDATION_ERROR (400) with the fields that were wrong.

The full description

Every route, field and answer is in the OpenAPI description. Import it into Postman or any OpenAPI tool to try the API.