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. - Getting access. Sign in and create your own workspace with a linked GitHub account, or get invited to an existing one by a workspace admin. Questions? 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.
- Under active development. uploads.sh is built in the open, so APIs (including auth) can still change. Feedback is welcome — open an issue on the GitHub repo.
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.