Member API — first upload
POST /api/v1/upload with file + agree_tos. Chunked init/part/complete also available. Needs upload scope.
Member API — first upload
Upload a file with your Member API key.
Where to find it
Docs: /api · endpoint POST /api/v1/upload
How it works
Authorization: Bearer YOUR_KEY + scope upload.
Simple multipart:
curl -X POST "https://<host>/api/v1/upload" \
-H "Authorization: Bearer YOUR_KEY" \
-F "agree_tos=1" -F "file=@./document.pdf"Success returns id, publicCode, size, status: "active", etc. Also: /upload/from-url, /upload/copy-from-public, and chunked init → part → complete (parts often 2 MiB). Default upload rate 30/hr.
Same storage/size/quota/geo gates as browser upload. Missing agree_tos fails.
Common problems
Missing ToS acceptance
Request fails without agree_tos=1|true.
Remote URL / copy blocked
Those mods/tier blocks still apply.