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.png
2. 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.png
3. 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 size5 GB per file
Total storage100 GB (free tier), unlimited (paid)
Presigned URL TTL1 minute – 7 days
File TTL1 hour – 1 year (or never)
Metadata per file8 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.