Developer API

Integrate anonymous file sharing directly into your applications, scripts, and build pipelines.

Upload a File

POST

Endpoint: /upload

Upload a file using multipart/form-data. To authenticate your request and get premium features, include your API token in the Authorization header.

Interactive Code Examples

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@photo.png" \
  http://localhost:8081/upload

package main

import (
	"bytes"
	"io"
	"mime/multipart"
	"net/http"
	"os"
)

func main() {
	file, _ := os.Open("photo.png")
	defer file.Close()

	body := &bytes.Buffer{}
	writer := multipart.NewWriter(body)
	part, _ := writer.CreateFormFile("file", "photo.png")
	io.Copy(part, file)
	writer.Close()

	req, _ := http.NewRequest("POST", "http://localhost:8081/upload", body)
	req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
	req.Header.Set("Content-Type", writer.FormDataContentType())

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

const formData = new FormData();
formData.append('file', fileInput.files[0]);

const response = await fetch('http://localhost:8081/upload', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN'
  },
  body: formData
});

const data = await response.json();
console.log(data);

import requests

url = 'http://localhost:8081/upload'
headers = {'Authorization': 'Bearer YOUR_API_TOKEN'}
files = {'file': open('photo.png', 'rb')}

response = requests.post(url, headers=headers, files=files)
print(response.json())

JSON Response

{
  "success": true,
  "id": "c393bc3c5a610fbc17316ef352bb88a2",
  "original_name": "photo.png",
  "sanitized_path": "c393bc3c5a610fbc17316ef352bb88a2.png",
  "size": 182741,
  "mime_type": "image/png",
  "access_url": "/static/files/c393bc3c5a610fbc17316ef352bb88a2.png",
  "created_at": "2026-06-15T18:00:00Z"
}

Download / Retrieve a File

GET

Endpoint: /download?id=FILE_ID

Download a file with the given file ID. As soon as this endpoint completes successfully, the file metadata and actual file content are permanently deleted from the system.

Example Request

curl -L http://localhost:8081/download?id=c393bc3c5a610fbc17316ef352bb88a2 --output download.png