# AgentBuilders.app > One API call. Full-stack apps. Where agent-built apps go live. ## What is AgentBuilders? AgentBuilders is an agent-native full-stack app hosting platform. AI agents deploy web apps with database storage, file storage, user authentication, and role-based access control via a single API call and get a live URL in under 2 seconds. ## API Base URL https://api.agentbuilders.app ## Authentication Most management/API endpoints require an API key via Authorization header: Authorization: Bearer YOUR_API_KEY Anonymous publish is supported at POST /deploy (no API key), private-by-default with 24h TTL + claim flow. ## Core Capabilities - **Deploy**: POST /deploy - Deploy a full-stack app with one call - **Database**: SQL database per app, defined in deploy payload - **File Storage**: Upload/download files up to 25MB per app - **User Auth**: Register/login/sessions per app - **RBAC**: Role-based access control with hierarchy and inheritance - **Private by Default**: Apps require a viewKey; public is opt-in ## Deploy Example POST https://api.agentbuilders.app/deploy Content-Type: application/json Authorization: Bearer YOUR_API_KEY { "name": "my-app", "files": { "index.html": "

Hello

" } } Response includes: url, viewKey, capabilities, version ## Deploy with Database Add a "storage.database.tables" object to your deploy payload: { "name": "my-crm", "files": { "index.html": "..." }, "storage": { "database": { "tables": { "contacts": { "name": "TEXT", "email": "TEXT" } } } } } ## Manage Apps - GET /apps - List all your apps - GET /apps/:name - Get app details - PATCH /apps/:name - Update app settings (public/private, slug) - DELETE /apps/:name - Delete an app (7-day name quarantine) ## Error Handling All API errors return structured JSON with: - _ok: false - error: machine-readable error code (e.g., "rate_limit_exceeded") - message: human-readable description - fix: specific recovery instruction for agents ## Rate Limits - API: 60 requests/min - Deploy: 30/hour per app, 60/hour per key - App serving: 120 requests/min - Auth: 20 attempts per 15 min ## Subscription & Billing - POST /checkout - Create Stripe Checkout session for paid tier upgrade - GET /subscription - Check your subscription status and limits - GET /founder-status - Check Founder's Edition batch availability ## Escalation - POST /escalate - Request a limit bump (when hitting rate limits) - GET /escalate - Check escalation status ## Edge AI (Credits-Based) - POST /ai/run - Run AI inference (consumes credits based on model + tokens) - GET /ai/budget - Check credit balance, auto-top-up settings, and rate limits - POST /ai/credits - Purchase credits via Stripe Checkout - GET /ai/credits/ledger - Credit transaction history (paginated) - PATCH /ai/settings - Configure auto-top-up - GET /ai/usage - AI usage statistics - New accounts get $5 trial credit (expires 90 days); purchase more anytime (never expire) - Credits never expire. When balance is $0, AI calls return 402. ## Two-Phase Deploy (Large Files) - POST /deploy/init - Start chunked deploy, get upload URLs - PUT /deploy/{id}/upload/{filename} - Upload individual files to R2 - POST /deploy/{id}/finalize - Complete the deploy ## Custom Domains - POST /domains - Register a custom domain (Cloudflare for SaaS) - GET /domains - List your custom domains - GET /domains/{hostname}/status - Check domain verification status ## RBAC (Role-Based Access Control) - Define roles with permissions and inheritance in the deploy payload - Built-in scopes: data:read, data:write, data:delete, files:read, files:write, files:delete, users:manage - First registered user per app gets admin role automatically ## Data Export - GET /apps/{name}/export - Full JSON export of schema, data, files, and users ## Tiers - **Free**: 3 apps, 5K rows, 50MB storage, $0/mo - **Hobby**: 10 apps, 50K rows, 500MB storage, $9/mo - **Pro**: 25 apps, 250K rows, 5GB storage, $19/mo - **Studio**: 100 apps, 2.5M rows, 50GB storage, $49/mo - **Founder's Edition**: Lifetime Studio-tier, one-time payment ($99-$249) ## Limits (Free tier) - Max apps: 3 - Max files per app: 100 - Max file size: 25MB - Max DB rows: 5,000 - App name: 1-63 chars, lowercase alphanumeric + hyphens ## Documentation Full docs: https://agentbuilders.app/docs Terms: https://agentbuilders.app/terms Privacy: https://agentbuilders.app/privacy ## Access AgentBuilders is currently invite-only. Request access at https://agentbuilders.app