REST API

Simple file sharing for every stack.

Upload files with a standard multipart request and receive clean JSON containing the share link, expiration settings and private deletion token.

Multipart uploads Predictable JSON Temporary links Token-based deletion

Upload a file

Send a multipart/form-data request to POST /api/files. Repeat the file field when uploading several files in one request.

curl -X POST \\
  -F "file=@report.pdf" \\
  -F "expires=7d" \\
  -F "maxDownloads=1" \\
  -F "autoDelete=true" \\
  https://uploaduae.com/api/files

Request fields

file: file to upload; repeat for multiple files.
expires: duration such as 30m, 1d, 2w or 1M.
maxDownloads: permitted download count.
autoDelete: remove the file after its final permitted download.
text: optional temporary text when no file is provided.
textName: optional filename for temporary text.

Successful response

{
  "success": true,
  "key": "a8Kq2LmP9x",
  "link": "https://uploaduae.com/a8Kq2LmP9x",
  "expires": "2026-06-29T10:00:00Z",
  "maxDownloads": 1,
  "autoDelete": true,
  "deleteToken": "private-token-returned-once"
}

Error format

API errors use a consistent JSON structure so they can be handled safely in any client.

{
  "success": false,
  "status": 400,
  "error": "invalid_expiration",
  "message": "Expiration value is not valid."
}

HTTP status codes

201Upload created

400Invalid request

403Invalid token

404File unavailable

413Upload too large

429Rate limit reached

The deletion token is returned only when a file is created. Store it securely if your application needs to remove the upload later.