Upload files

Single-request, legacy, and multipart upload flows.

Getting started Authentication Uploads Files Folders Examples Errors and limits

Single-file upload

Authenticated uploads use the account visibility default unless overridden with visibility=private or visibility=public. Anonymous uploads may only be public; requesting private returns 400.

FieldTypeBehavior

filefileRequired upload contents

visibilitystring"private" or "public"; account default when omitted

expiryDaysnumber1–3650; defaults to 365

maxDownloadsnumber0 means unlimited

randomizeNamebooleanReplace stored filename when true

urlTypestring"uuid" or "short"

Legacy upload

This route remains supported for existing clients. It is always public, rejects visibility=private, and keeps its short-link default and 30-day expiry ceiling.

cURL

curl https://mbr.pub/api/upload -F "[email protected]" -F "expiryDays=7"

Multipart lifecycle

Initialize with file metadata, upload numbered binary parts, then complete with each returned ETag. Abort removes the pending R2 and database state.

PreviousAuthentication NextFiles