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.