Upload
Upload one or more files to R2 storage
Accepts up to 10 files as multipart/form-data under the files field. Each file is uploaded to R2 under a per-organization storage key and returned with a freshly generated signed URL.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Multipart form. Send each file as a separate files part. Example with curl: curl -F "files=@invoice.pdf" -F "files=@receipt.png" -H "Authorization: Bearer $TOKEN" /api/upload.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/upload" \ -F files="[ \"<binary: invoice.pdf>\", \"<binary: receipt.png>\" ]"{ "files": [ { "key": "orgs/65b1f0a2c3d4e5f6a7b8c9d0/uploads/2026-05-18/invoice.pdf", "type": "application/pdf", "name": "invoice.pdf", "size": 184221, "signedUrl": "https://r2.example.com/orgs/65b1.../invoice.pdf?token=...", "bucket": "tether-uploads" } ]}