← back

FILEDITCH API

Simple HTTP uploads, no auth

The FileDitch API is dead simple. POST a file, get a JSON response with a URL. No API keys, no accounts, no bullshit.

Uploads — new.fileditch.com

Files are kept as long as storage allows — no scheduled expiry. See retention under Limits below.

Endpoint
POSThttps://new.fileditch.com/upload.php
Raw body upload — fastest method
curl -T yourfile.mp4 "https://new.fileditch.com/upload.php?filename=yourfile.mp4"
Raw POST with --data-binary
curl -X POST \
  -H "Content-Type: application/octet-stream" \
  --data-binary @yourfile.mp4 \
  "https://new.fileditch.com/upload.php?filename=yourfile.mp4"
Multipart — also works
curl -F "file=@yourfile.mp4" https://new.fileditch.com/upload.php

Filename

The server resolves the filename in this order. The first match wins:

1.  ?filename=  query parameter
2.  X-Filename  request header
3.  Content-Disposition header  (filename="..." or RFC 5987 filename*=)
4.  Multipart field filename
5.  Random hex string           (fallback)

Spaces are replaced with underscores automatically. Unicode filenames are preserved.

Success response

successboolean — always true on success
urlstring — direct link to the uploaded file
filenamestring — final filename stored on server
sizeinteger — file size in bytes
Example
{
  "success": true,
  "url": "https://fileditchfiles.st/alpha19/a3f9c1b2d4e5f6071829/yourfile.mp4",
  "filename": "yourfile.mp4",
  "size": 104857600
}

Error response

{ "error": "description" }
400Empty file, no file sent, or incomplete upload (connection closed early)
403Blocked file type (executables, scripts, web files)
405Wrong HTTP method
413File exceeds 150 GB limit
500Server error

Limits

Max file size150 GB
RetentionIndefinite while accessed — only files untouched for 45+ days may be removed, and only when space is needed
Blocked extensionsphp, html, js, exe, apk, sh, py, bat and other executables & scripts
AuthenticationNone required