# Rumata Docs

> Product guides for non-technical builders and developers. Agents building on Rumata: start with https://docs.rumata.dev/api/docs/agent-reference?format=markdown. Public documentation only; no account operations.

## Interfaces

- [JSON catalog](https://docs.rumata.dev/api/docs)
- [OpenAPI](https://docs.rumata.dev/api/openapi.json)
- [Full Markdown corpus](https://docs.rumata.dev/llms-full.txt)
- [Streamable HTTP MCP](https://docs.rumata.dev/mcp)

## Guides
- [Explore System Explorer](https://docs.rumata.dev/api/docs/system-explorer?format=markdown): Find the data, workflows, code, and infrastructure behind your application in one place.
- [Overview](https://docs.rumata.dev/api/docs/system-explorer-overview?format=markdown): Read your app’s activity, investigate issues, and explore detailed monitoring.
- [Database](https://docs.rumata.dev/api/docs/system-explorer-database?format=markdown): Use schema diagrams, SQL, visual queries, exports, and recovery tools in Database Studio.
- [Workflows](https://docs.rumata.dev/api/docs/system-explorer-workflows?format=markdown): Find, inspect, test, and troubleshoot your application’s automations.
- [Activities](https://docs.rumata.dev/api/docs/system-explorer-activities?format=markdown): Extend your application's capabilities with reusable operations, AI-generated functionality, and ready-made integrations.
- [Services](https://docs.rumata.dev/api/docs/system-explorer-services?format=markdown): Build, run, and manage the backend services that power your application—all in one place.
- [Frontend](https://docs.rumata.dev/api/docs/system-explorer-frontend?format=markdown): Monitor your live website, track traffic, and manage deployments—all from your Rumata workspace.
- [Code](https://docs.rumata.dev/api/docs/system-explorer-code?format=markdown): Browse source files, inspect changes, and save or push your application code.
- [Keys & secrets](https://docs.rumata.dev/api/docs/system-explorer-secrets?format=markdown): Manage your API keys and sensitive credentials securely—all in one place.
- [Storage](https://docs.rumata.dev/api/docs/system-explorer-storage?format=markdown): Store, organize, and manage your application's files—all from your Rumata workspace.
- [Permissions](https://docs.rumata.dev/api/docs/system-explorer-permissions?format=markdown): Control exactly who—or what—can access your application's resources.
- [Tutorial: Build a feedback board](https://docs.rumata.dev/api/docs/feedback-board?format=markdown): Create a feedback board from a prompt, try it with sample data, and make your first improvement.
- [Build your first app](https://docs.rumata.dev/api/docs/first-app?format=markdown): Describe your idea, build a first version, and refine it in Preview.
- [Run your first workflow](https://docs.rumata.dev/api/docs/first-workflow?format=markdown): Build a two-step workflow that takes a name and returns a greeting. Run it, inspect the output, and try a different input.
- [Create an application](https://docs.rumata.dev/api/docs/create-project?format=markdown): Start with an idea and let Rumata prepare your workspace.
- [Understand your app](https://docs.rumata.dev/api/docs/understand-project?format=markdown): Optional for beginners. Explore the resources behind your application, or go directly to Test.
- [Test your app](https://docs.rumata.dev/api/docs/testing?format=markdown): Test your application from a customer’s perspective before sharing it.
- [Manage your app](https://docs.rumata.dev/api/docs/manage-project?format=markdown): Your application is live! Now it’s time to keep things running smoothly. With Rumata, you can monitor your application’s activity, track resource usage, manage your team, and continue making improvements—all from the same workspace.
- [Build more complex workflows](https://docs.rumata.dev/api/docs/complex-workflows?format=markdown): Connect several actions, pass data between them, and handle different outcomes.
- [Check your usage](https://docs.rumata.dev/api/docs/usage?format=markdown): See how much of your plan you have used and what remains.
- [Accept an invitation](https://docs.rumata.dev/api/docs/invitations?format=markdown): Join the group invited to your exact Rumata account nickname.
- [Idle hibernation](https://docs.rumata.dev/api/docs/hibernation?format=markdown): Understand what goes to sleep, how it wakes up, and where to change the timer.
- [Set up your account](https://docs.rumata.dev/api/docs/getting-started?format=markdown): Sign in, choose your plan, and open Home.
- [Navigate your workspace](https://docs.rumata.dev/api/docs/workspace?format=markdown): Find your way around the workspace and follow the first conversation.
- [Build and improve your app](https://docs.rumata.dev/api/docs/prompting?format=markdown): Ask for a change, wait for the update, and review the result.
- [Build and run workflows](https://docs.rumata.dev/api/docs/workflows?format=markdown): Connect steps into a repeatable process, from the first event to the final result.
- [Work with databases](https://docs.rumata.dev/api/docs/databases?format=markdown): Store structured information, understand tables, and inspect database health.
- [Manage project files](https://docs.rumata.dev/api/docs/storage?format=markdown): Keep uploaded files in project storage and understand capacity, access, and recovery.
- [Publish your app](https://docs.rumata.dev/api/docs/publishing?format=markdown): Review the exact source, website, backend services and workflow versions, then verify the released application.
- [Groups and permissions](https://docs.rumata.dev/api/docs/collaboration?format=markdown): Groups bring members together. Permissions define what each group can do.
- [Understand plans and usage](https://docs.rumata.dev/api/docs/billing?format=markdown): Choose a cloud bundle, understand included and purchased resources, and identify the allowance behind a limit.
- [Troubleshoot with a clear next step](https://docs.rumata.dev/api/docs/troubleshooting?format=markdown): Find the failing layer before you restart, rebuild, or change data.
- [How Rumata fits together](https://docs.rumata.dev/api/docs/architecture?format=markdown): Connect your frontend, managed backend, database, files and workflows, and understand how each runs.
- [Code and development machines](https://docs.rumata.dev/api/docs/development?format=markdown): Understand your retained workspace, running frontend and backend, source history and machine lifecycle.
- [Secrets and integrations](https://docs.rumata.dev/api/docs/secrets?format=markdown): Connect external services while keeping credentials out of prompts and frontend code.
- [HTTP and scheduled triggers](https://docs.rumata.dev/api/docs/triggers?format=markdown): Start a workflow from an external request or a recurring schedule.
- [Create and deploy activities](https://docs.rumata.dev/api/docs/activities?format=markdown): Create reusable workflow operations, deploy them, and check their status.
- [AI agents inside workflows](https://docs.rumata.dev/api/docs/ai-workflows?format=markdown): Add an AI step to your workflow and choose the tools it can use.
- [Connect external services](https://docs.rumata.dev/api/docs/connectors?format=markdown): Use workflow connectors and incoming events to connect Rumata with other tools.
- [Documentation for AI agents](https://docs.rumata.dev/api/docs/agents?format=markdown): Read the same Rumata guides through JSON, Markdown, or a read-only MCP server.
- [Rumata, in plain language](https://docs.rumata.dev/api/docs/glossary?format=markdown): A shared vocabulary for people building the product and developers extending it.
- [Build and connect backend services](https://docs.rumata.dev/api/docs/backends?format=markdown): Choose a Docker Hub image, a Dockerfile, or native Node.js/Python source, then connect the service to your frontend.
- [API keys for backends and workflows](https://docs.rumata.dev/api/docs/api-keys?format=markdown): Authorize a server-side integration to call published workflows and storage APIs without exposing service credentials to application users.
- [Agent reference: build on Rumata](https://docs.rumata.dev/api/docs/agent-reference?format=markdown): Start here for the technical contracts, rules and capabilities that AI agents and developers need when building apps on Rumata.
- [Accounts and authentication for apps](https://docs.rumata.dev/api/docs/agent-accounts?format=markdown): What native email and password accounts provide, how sessions and ownership work, and when to build another sign-in method.
- [Backends and bindings](https://docs.rumata.dev/api/docs/agent-backends?format=markdown): Contracts for hosting APIs, containers and workers on Rumata: configuration, access, runtime policy, builds and frontend bindings.
- [Database for apps and workflows](https://docs.rumata.dev/api/docs/agent-database?format=markdown): How apps persist relational data in the factory PostgreSQL database, run SQL from workflows, enable extensions and prove persistence.
- [File storage for apps](https://docs.rumata.dev/api/docs/agent-storage?format=markdown): How apps upload, list, sign and delete files in managed project storage, with per-user ownership, size and type limits.
- [Workflows and connectors](https://docs.rumata.dev/api/docs/agent-workflows?format=markdown): Contracts for authoring workflow graphs, running them from backends, scheduling, connectors, API keys and durable jobs.
- [AI agent steps](https://docs.rumata.dev/api/docs/agent-ai-steps?format=markdown): How to add AI behavior with the native agent node: billing, outputs, files and images, callable tools and trusted user scope.
- [Verification protocol](https://docs.rumata.dev/api/docs/agent-verification?format=markdown): How to prove that backends, workflows, AI steps and frontends work, what counts as evidence, and how to test signed-in apps safely.
- [External MCP capability map](https://docs.rumata.dev/api/docs/agent-external-mcp?format=markdown): Which public Rumata MCP capability to use for each need when working without a development machine, and how it differs from the documentation MCP.
- [Platform capabilities](https://docs.rumata.dev/api/docs/agent-capabilities?format=markdown): The cloud capabilities Rumata provides, and the functional capabilities you build from them, such as passwordless login, bots, roles and integrations.
- [Build a full-stack app](https://docs.rumata.dev/api/docs/agent-quickstart?format=markdown): The end-to-end order of work for a persisted app with a frontend, a managed backend, a database, and optional accounts, files and AI.
- [Tool catalog](https://docs.rumata.dev/api/docs/agent-tools?format=markdown): Every Rumata capability by name: the native tool on a development machine and the matching public MCP tool or operation.
- [Frontends on Rumata](https://docs.rumata.dev/api/docs/agent-frontend?format=markdown): How to activate a frontend, connect it to managed backends and workflows, follow source rules, and publish it.
- [Deployment and release](https://docs.rumata.dev/api/docs/agent-deployment?format=markdown): How to settle deployment intent, get approval, build, deploy and publish backends and frontends, and verify a release.
- [Activities](https://docs.rumata.dev/api/docs/agent-activities?format=markdown): Which standard workflow activities to use, and how to build, deploy and debug custom Python activities from Git.
- [Connect backends and workflows](https://docs.rumata.dev/api/docs/agent-integration?format=markdown): How private workflows, API keys, backends and storage call each other, including publication, credentials, results and identity.
- [Durable jobs](https://docs.rumata.dev/api/docs/agent-durable-jobs?format=markdown): How to run media generation and ETL as recoverable jobs: one durable workflow per job, safe admission, crash recovery and capacity release.
- [Agent troubleshooting](https://docs.rumata.dev/api/docs/agent-troubleshooting?format=markdown): Exact symptoms agents hit on Rumata, what causes them, and the fix, across backends, frontends, data, files, workflows and AI.
- [Home, sign-in & account controls](https://docs.rumata.dev/api/docs/controls-home-account?format=markdown): Learn what each navigation link, account action, and first-prompt control does.
- [Chat, sessions, models, and file controls](https://docs.rumata.dev/api/docs/controls-chat?format=markdown): Choose a conversation and model, give the assistant context, queue instructions, and navigate its replies.
- [Chat approvals, questions, goals, and recovery](https://docs.rumata.dev/api/docs/controls-chat-decisions?format=markdown): Respond to the assistant’s requests for decisions, connect an agent account, manage goals, and recover interrupted work.
- [Usage & pricing controls](https://docs.rumata.dev/api/docs/controls-billing?format=markdown): Inspect account allowances, customize a cloud bundle, and review resource purchases before paying.
- [Factory settings & machine controls](https://docs.rumata.dev/api/docs/controls-factory?format=markdown): Rename a factory, choose its coding agent, manage machine resources, and understand deletion scope.
- [Overview, health, and recovery-screen controls](https://docs.rumata.dev/api/docs/controls-overview?format=markdown): Review your application’s activity, investigate problems, and check resource health.
- [Frontend publishing and traffic controls](https://docs.rumata.dev/api/docs/controls-frontend?format=markdown): Publish pushed code, inspect deployments, understand deployment warnings, and read production traffic measurements.
- [Preview, network, and console controls](https://docs.rumata.dev/api/docs/controls-preview?format=markdown): Navigate your app as you build, check screen sizes, investigate requests and errors, and understand when a test sends a real request.
- [Code editor, file browser, and Git controls](https://docs.rumata.dev/api/docs/controls-code?format=markdown): Understand the full development editor, the read-only source viewer, and the actions that save files or push them to Git.
- [Embedded editor menu reference](https://docs.rumata.dev/api/docs/controls-code-menus?format=markdown): Look up file commands, text editing, navigation, debugging, and terminal actions in Rumata’s full code editor.
- [Activity creation and deployment controls](https://docs.rumata.dev/api/docs/controls-activities?format=markdown): Find reusable actions, create a Python activity, configure its inputs, and inspect builds and deployments.
- [Built-in activity field reference](https://docs.rumata.dev/api/docs/controls-builtin-activities?format=markdown): Every declared field in the built-in database, file-storage, app-login, and app-registration activity forms.
- [Workflow list, canvas, and version controls](https://docs.rumata.dev/api/docs/controls-workflows?format=markdown): Find an automation, edit its steps, understand Save and Create, and manage versions and data contracts.
- [Add a step: palette and webhook controls](https://docs.rumata.dev/api/docs/controls-workflow-palette?format=markdown): Choose the right kind of automation step, find built-in activities, and understand what a service webhook configures.
- [Workflow trigger and schedule controls](https://docs.rumata.dev/api/docs/controls-workflow-triggers?format=markdown): Choose how a workflow starts, define its HTTP route, manage a server schedule, and control execution history.
- [Workflow step settings and data controls](https://docs.rumata.dev/api/docs/controls-workflow-nodes?format=markdown): Configure activity calls, HTTP requests, conditions, waits, field transformations, and reusable input controls.
- [AI workflow step and connector controls](https://docs.rumata.dev/api/docs/controls-workflow-agents?format=markdown): Choose an AI model, tools, output format, and payer, or configure a service connector’s operation and credentials.
- [Connector operations and every input field](https://docs.rumata.dev/api/docs/controls-connectors?format=markdown): Look up the operation names, required fields, examples, credentials, and request details in Rumata’s seeded connector catalog.
- [Workflow run and performance controls](https://docs.rumata.dev/api/docs/controls-workflow-runs?format=markdown): Prepare a test request, execute a saved workflow, and investigate outcomes, timing, and individual steps.
- [File storage controls](https://docs.rumata.dev/api/docs/controls-storage?format=markdown): Browse buckets, preview files, upload content, share temporary links, and understand move, overwrite, and deletion behavior.
- [Secret controls](https://docs.rumata.dev/api/docs/controls-secrets?format=markdown): Add or update secrets, manage access, and find the references your workflows use.
- [Groups, invitations, and access controls](https://docs.rumata.dev/api/docs/controls-access?format=markdown): Understand who belongs to a group, which resources it can use, and when permission changes take effect.
- [Database editor controls](https://docs.rumata.dev/api/docs/controls-database?format=markdown): Find a table, build or save a query, inspect results, and understand exactly when a database action changes your data.
- [Table, diagram and schema-editing controls](https://docs.rumata.dev/api/docs/controls-database-tables?format=markdown): Explore real table structure, arrange the schema diagram, and review SQL before applying a schema change.
- [Database operations and recovery controls](https://docs.rumata.dev/api/docs/controls-database-operations?format=markdown): Understand database sleep, capacity, access, backup, and recovery before applying a change.