Uploader API

ShareX-compatible file uploader and URL shortener that serves files from your own Hep.gg account, authenticated with a per-account bearer token.

Uploader API

The Hep.gg Uploader lets you upload files and shorten URLs to your own Hep.gg account programmatically. It is fully ShareX-compatible: the same POST /upload endpoint that the desktop client uses is a plain HTTP API you can call from curl, a script, or any HTTP library. Uploaded files are served back from your account's configured host (https://i.hep.gg by default), and you can point your own *.hep.gg subdomain or a custom CDN domain at them.

Plans

The Uploader has two plans:

  • Free plan. Starts the moment you apply from the dashboard, no review needed. Upload images, and video too if you have Prime. Every upload is deleted automatically 30 days after you make it. Renaming, short links and text uploads are not included.
  • Full access. Everything on this page: renaming, short links and text uploads, and uploads are kept for good. Other file types are enabled for your account on request. After you've used the free plan for a while, the Uploader Overview offers a way to ask for full access, and an invite from a full-access user unlocks it straight away. Moving to full access keeps every upload you already have.

With Prime, video uploads are allowed on either plan.

Authentication

Every upload request carries your account's uploader bearer token in the Authorization header. There is no query-string or cookie alternative for programmatic use.

Authorization: <your-token>

The token is matched verbatim against your account's key record, so send it exactly as issued. A Bearer or Token prefix is accepted but not required, all three of these work:

Authorization: hyd-up-xxxxxxxxxxxx
Authorization: Bearer hyd-up-xxxxxxxxxxxx
Authorization: Token hyd-up-xxxxxxxxxxxx

New tokens look like hyd-up-<random>. The token grants full access to your uploader, so treat it like a password.

Where the token comes from

There is no public "create a key" endpoint. You mint, view, and rotate the token from the dashboard: open the Uploader app, go to the Setup / API Keys subpage, and copy the generated token. Rotating the key from that page immediately revokes the old token. See Authentication and keys for the full lifecycle.

Quickstart

Upload a file with one multipart request. The field name does not matter, the first file in the request is used.

curl
curl -X POST https://hep.gg/upload \
  -H "Authorization: hyd-up-xxxxxxxxxxxx" \
  -F "file=@screenshot.png"

Response:

{
  "ID": "abc123.png",
  "url": "https://i.hep.gg/abc123.png"
}

What is in these docs