Reference
Reference
Manage what you've uploaded, and what's worth knowing before you rely on it.
Manage what you uploaded #
uploads list # see your files
uploads delete <key> # remove a file
uploads usage # storage used by your workspace
uploads staged # what's queued for this branch
uploads --help # everything else
Good to know #
- Hosted files are public. Anyone with the URL can view them, even media attached to private repositories. Don't upload secrets or sensitive UI.
- The visibility toggle unlists — it doesn't lock down bytes. Marking a file "private" hides it from your workspace's public file listing and gates the
/f/…page behind sign-in. The raw file URL (storage.uploads.sh/…) keeps serving the same bytes to anyone who already has it, and edge caches can keep serving recently-public bytes for a short window after the toggle. Treat it as "unlisted," not "private." True byte-level privacy would require a workspace with no public domain (signed URLs only), which isn't how uploads.sh workspaces work today. - Share pages support embeds. Every public file and gallery has a page at
/f/…or/g/…withoEmbed discovery, so tools that unfurl links can show the media. The endpoint isGET /oembed?url=<page-url>&format=json. - Access is by invitation. There's no self-serve signup right now. If you'd like in, reach out via the GitHub repo.
- Everything lands in your workspace. Files are stored under a prefix for your workspace, and PR/issue attachments get stable, predictable paths, so re-attaching an updated screenshot replaces the old URL's spot instead of littering.
- Still early. uploads.sh is built in the open and APIs may change without notice. Don't depend on it for anything you can't afford to re-key.
Looking for deeper material like the REST API, enrollment internals, self-hosting, or operator docs? It all lives in the GitHub repository. Agents can also read /llms.txt for a machine-friendly index.