Primitives Object Storage
Object Storage API
File storage over HTTP. Upload and download with presigned URLs — no S3 to manage.
Get upload URL PUT file Get download URL (optional)
Quickstart
Upload and download files in three simple steps.
1. Get upload URL
Request a presigned URL for your file.
POST https://api.rocketstack.dev/storage/objects
Content-Type: multipart/form-data
file=@avatar.png, path=uploads/avatar.png2. Upload file
PUT your file directly to the presigned URL.
# Upload is a single request (multipart):
POST https://api.rocketstack.dev/storage/objects
file=@avatar.png, path=uploads/avatar.png3. Get download URL
Generate a time-limited download link.
POST https://api.rocketstack.dev/storage/download-url
{
"path": "uploads/avatar.png",
"expiresInSeconds": 900
}Features
Everything you need for file storage.
Presigned URLs
Secure, time-limited URLs for uploads and downloads. No credentials exposed to clients.
TTL support
Auto-expire files after a duration. Perfect for temporary uploads and cache files.
Custom metadata
Attach key-value metadata to files. Filter and search by metadata.
Access control
Fine-grained permissions per file or prefix. Public or private access.
Limits & Quotas
Generous defaults, adjustable on request.
| Resource | Limit |
|---|---|
| Max file size | 5 GB per file |
| Total storage | 100 GB (free tier), unlimited (paid) |
| Presigned URL TTL | 1 minute – 7 days |
| File TTL | 1 hour – 1 year (or never) |
| Metadata per file | 8 KB |
Pricing
Simple, usage-based pricing.
Pay for storage used and bandwidth consumed. See exact rates and usage in the console .
Use Cases
Common patterns for the Object Storage API.
User uploads
Avatars, documents, or any user-generated content. Presigned URLs keep credentials server-side.
Assets & media
Images, videos, and static assets for your app. Serve via CDN or generate time-limited links.
Backups & archives
Store exports, backups, or logs with optional TTL. No buckets or lifecycle rules to configure.
Ready to store your first file?
Get your API key and start uploading in minutes.