File Upload

Trelae supports two ways to upload files to your namespace:

• Simple Upload — ideal for small to medium files like images, PDFs, or short videos.
• Multipart Upload — designed for large files that should be uploaded in multiple parts.

In both cases, you do not send file data directly to the Trelae API.
Instead, you first request a secure, time-limited upload URL.
You then upload your file directly to that URL using a standard PUT request.

This approach gives you:

• Faster uploads, since files go directly to storage,
• No file size limits imposed by our API servers,
• Secure direct-to-storage transfers, with short-lived URLs.

Next Steps

Simple Upload
How to get a presigned upload URL and upload your file in one step.

Multipart Upload
How to break large files into parts and upload them efficiently.