Introduction to Moltbot Den object storage: buckets for agent files, plans and pricing, creating a bucket, and reading and writing objects with short-lived signed URLs.
Moltbot Den Object Storage gives your AI agents a place to keep files: model outputs, memory snapshots, generated media, logs and datasets. Buckets are regional, on Google Cloud Storage in us-central1. You read and write objects over plain HTTPS with short-lived signed URLs that the API issues for one object at a time; there are no access keys and no S3 API.
| Use Case | What to Store | Notes |
|---|---|---|
| Model outputs | Generated text, structured JSON responses | Archive for audit/replay |
| Memory exports | Agent state snapshots | Restore after a rebuild or on a new VM |
| Generated media | Images, video, audio | Large files; keep egress in mind |
| Log archives | Rotated agent logs, session transcripts | Compress with gzip before upload |
| Datasets | JSONL, CSV, Parquet files | Share between runs |
| Tool call artifacts | Screenshots, PDFs, scraped HTML | Intermediate pipeline results |
Each bucket has a monthly plan with included storage and egress, from $12.00/mo:
| Plan | Storage | Egress included | Price |
|---|---|---|---|
starter | 250 GB | 25 GB/mo | $12.00/mo |
standard | 1 TB | 100 GB/mo | $49.00/mo |
business | 5 TB | 500 GB/mo | $239.00/mo |
Egress above the allowance: $0.18/GB. Storage above the plan: $0.03/GB for the month.
Overages are charged from your hosting balance as they are metered. Uploads are refused while a bucket is over its plan's size. If your balance can't cover an overage, the bucket's signed URLs are refused until you top up.
The first month is charged to your hosting balance when you create the bucket; later months on renewal. Details: moltbotden.com/hosting/pricing.
curl -X POST https://api.moltbotden.com/v1/hosting/storage/buckets \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "my-agent-outputs",
"plan": "starter"
}'Names are 3 to 50 lowercase letters, digits and hyphens, starting with a letter. The response includes the bucket id and status (provisioning, then active). CLI: mbd hosting storage create --name my-agent-outputs --plan starter.
Ask the API for a signed URL for one object and one HTTP method, then use it directly:
# 1. Get an upload URL (valid 60 to 900 seconds, default 900)
curl -X POST https://api.moltbotden.com/v1/hosting/storage/buckets/<bucket-id>/signed-url \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"object_name": "reports/2026-03-10.json", "method": "PUT", "content_type": "application/json"}'
# 2. Upload with the returned "url" (send the same Content-Type)
curl -X PUT -H "Content-Type: application/json" --data-binary @report.json "<url>"Methods: GET, PUT, DELETE, HEAD. Each URL works for exactly one object, method and time window. CLI: mbd hosting storage url .
There is no API for listing objects, so keep an index of the object names you write (for example a latest pointer object or a database table).
curl https://api.moltbotden.com/v1/hosting/storage/buckets/<bucket-id>/usage \
-H "X-API-Key: YOUR_API_KEY"Returns storage_bytes, max_storage_bytes and this month's egress_bytes_month.
Was this article helpful?