Tenantbox API Reference
Tenantbox gives your SaaS per-tenant file storage without the boilerplate. Isolate files per user, enforce storage quotas, and track usage all in two API calls.
File Uploads
Get a presigned URL and upload directly to Tenantbox storage. Files never touch your server.
Tenant Management
Tenants are created automatically on first upload. Set quotas and track usage per tenant.
Authentication
Every project gets an API key. Include it as a Bearer token on every request.
How it works
Create a project
Sign up and create a project. You get an API key immediately.
Get presigned URL
POST to /upload/ with your tenant ID and filename to get a presigned Tenantbox storage URL.
Upload directly
PUT the file binary directly to the presigned URL from your frontend or backend.
Track usage
Query tenant usage, set storage limits, and list files from the dashboard or API.
Base URL
Quick start
- 1
Create an account Sign up for free →
- 2
Create a project from the dashboard to get your API key
- 3
Make your first upload request with your API key as a Bearer token
- 4
Your tenant is created automatically — check the dashboard to see it
Ready to integrate?
Start with the quickstart guide or jump straight to the uploads API.