Uploading files

POST /upload to store a file under your Hep.gg account, with size and MIME limits, response shape, and error codes.

Uploading files#

Send a multipart form with one file part. The field name does not matter, the first file in the request is used. On success you get JSON with the upload's ID and public URL.

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

import { readFileSync } from "node:fs";
 
const form = new FormData();
form.append(
  "upload", // any field name works; the first file wins
  new Blob([readFileSync("screenshot.png")]),
  "screenshot.png",
);
 
const res = await fetch("https://hep.gg/upload", {
  method: "POST",
  headers: { Authorization: "hyd-up-xxxxxxxxxxxx" },
  body: form,
});
 
if (!res.ok) {
  throw new Error(`upload failed: ${res.status}`);
}
const { ID, url } = await res.json();
console.log(ID, url);

Request#

To shorten a URL or store text instead of a file, send a link field rather than a file part. That path is documented separately in URL shortener.

Response#

A successful file upload returns 200 with both an ID and a url:

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

Limits#

Two gates apply to every upload, both sourced from your account settings (adjust them on the uploader Settings subpage):

Errors#

All error bodies use the standard error envelope. Status codes are exact: