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.
Response:
{
"ID": "abc123.png",
"url": "https://i.hep.gg/abc123.png"
}