S3 setup. Upload flows. Permissions. Image resizing. CDN configuration. Audit logs. Usage tracking.
Zoblob handles it all—once, reused everywhere.
A complete file layer for modern applications
A structured abstraction over S3, inspired by Rails Active Storage
Call our API with file metadata. Get a presigned S3 URL valid for 5 minutes.
Browser uploads file directly to S3. No server limits. Works with files up to 5TB.
Notify Zoblob the upload finished. Attach to resources. Get CloudFront signed URL.
Perfect for SaaS, marketplaces, content platforms, and more
Start free, scale as you grow
Get up and running in minutes with our simple API
POST /api/v1/uploads/intent
X-API-Key: bs_your_api_key
Content-Type: application/json
{
"filename": "avatar.jpg",
"contentType": "image/jpeg",
"byteSize": 524288,
"recordType": "users", // Attach to users
"recordId": "user_123", // Specific user
"recordName": "avatar" // Field name
}PUT <uploadUrl>
Content-Type: image/jpeg
<file binary data>POST /api/v1/uploads/complete
X-API-Key: bs_your_api_key
Content-Type: application/json
{
"blobId": "blob_abc123"
}
// Response:
{
"blob": {
"id": "blob_abc123",
"url": "https://cdn.zoblob.com/...",
"filename": "avatar.jpg",
"contentType": "image/jpeg"
}
}POST /api/v1/projects/{projectId}/blobs/{blobId}/variants
X-API-Key: bs_your_api_key
{
"width": 400,
"height": 400,
"format": "webp",
"quality": 80
}