Totalum API — Overview & API Key
Programmatically create and manage full-stack AI-built applications — build your own vibe-coding tool on top of Totalum's infrastructure.
The Totalum API lets you programmatically create and manage full-stack web apps with AI. Send a natural-language prompt and an agent generates a complete project — frontend, backend, database, hosting, auth and deployment — all managed for you.
https://api-accounts.totalum.appapi-key: tlm_sk_… header{ errors, data } envelope#Who is it for
AI agents & coding tools
Give Claude Code, Codex, Cursor or any agent the power to build and deploy real apps through MCP.
Set up MCP →Developers & SaaS
Embed AI app-building into your own product. Create, run, query and deploy projects from your backend.
Browse endpoints →Agencies & whitelabel
Resell a fully branded AI app builder. Fork the open-source builder and connect it to the API.
Build your own →Your frontend talks to your backend; your backend talks to the Totalum API. Never call the API directly from client-side JavaScript, mobile apps, or any browser code.
CORRECT: User → Your Frontend → Your Backend → Totalum API
WRONG: User → Your Frontend → Totalum API#Get your API key
Your API key gates both the REST API and the MCP server. Keys are prefixed tlm_sk_.
- Open the API section in your Totalum account.
- Buy credits — the key is revealed once your account has an active credit balance. (Every operation is credit-metered.)
- A default key is created automatically. Reveal it, copy it, and optionally create additional named keys or restrict a key to specific projects.
#What you can do
- Create and manage full-stack projects programmatically.
- Run the AI builder with natural-language prompts.
- Query, create, and edit database records.
- Deploy to production with a global CDN.
- Manage secrets, files, and versions.
- Add custom domains and webhooks.
Totalum handles everything — hosting, database, file storage, SSL, CDN, deployments, and secret management. The agent even reads your project's backend logs to debug autonomously. The typical flow is: create a project → run the agent with a prompt → poll for status → deploy to production.
#Built-in integrations
Just mention them in your prompt — no keys or config needed. If one needs a key you haven't provided, the agent tells you via the secretKeysNeeded field; add it as a project secret and run again.
No key required: email delivery · PDF generation · AI image generation · ChatGPT · authentication · document scanning (OCR) · speech-to-text · video analysis · web scraping · managed database · deployment & hosting (CDN) · custom domains · file storage · backend-logs access.
Requires your key (add as a project secret): Stripe (payments & subscriptions) · email from your own domain (we recommend Resend).
Anything else: mention any API or npm package in your prompt and the agent integrates it.
#Credit model
- Development credits — project creation, running the agent, deployments, server start/restart, source download, uploads, version recovery, export/import, custom domains.
- Infrastructure credits — only when a project exceeds its plan's built-in usage limits (ChatGPT, image generation, video analysis, transcription, document scans, web scraping, emails, PDFs, uploads).
Most read endpoints (account, list/get projects, status, logs, database reads) are free. Set monthly caps per project with the credit-limits endpoint and monitor usage via spending analytics.
#Response envelope
Every response uses the same shape — on failure, errors holds { errorCode, errorMessage } and data is null:
{ "errors": null, "data": { } }#Explore the endpoints
Browse the full reference by resource in the sidebar under Totalum API, or jump to a common one:
- Projects — create, list, get, delete, credit limits.
- AI Agent — run the builder, poll status, conversation.
- Deployments — deploy to production.
- Database — query and mutate project data.
- GitHub — bidirectional repo sync.