Image upload API

The upload API is what ShareX uses, and any other tool or script can use it too. Uploads land in your image host, with the same limits as uploading in the browser.

Request#

The old address https://rage.wtf/api/imagehost/upload works the same way.

Response#

Status 200:

{
  "url": "https://rage.wtf/yourname/AbC1234",
  "direct_url": "https://...",
  "thumbnail_url": "https://...",
  "id": "q2V0...",
  "short_id": "AbC1234",
  "duplicate": false
}

What happens to the upload#

• With the Image Host plan, it goes into the folder chosen under ShareX uploads go to in the Folders tab, unless an automation sends it somewhere else. On the free plan there are no folders.
• Your expiring uploads setting and upload rules apply.

Limits#

Errors#

Errors return JSON with an error message, which ShareX shows as the error:

{ "error": "Files can be up to 10 MB." }

Examples#

curl#

curl -X POST https://rage.wtf/api/image-host/upload 
  -H "x-api-key: rage-your-key" 
  -F "[email protected]"

JavaScript (Node.js 20 or newer)#

import { openAsBlob } from 'node:fs';

const form = new FormData();
form.append('image', await openAsBlob('screenshot.png'), 'screenshot.png');

const response = await fetch('https://rage.wtf/api/image-host/upload', {
  method: 'POST',
  headers: { 'x-api-key': process.env.RAGE_API_KEY },
  body: form
});

const data = await response.json();
if (!response.ok) throw new Error(data.error);
console.log(data.url);