Upload

Upload one or more files to R2 storage

POST
/api/upload

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"    }  ]}