# GloriaMundo Documentation

> Complete documentation for GloriaMundo, an AI workflow automation platform with Glass Box transparency. Describe automations in plain English and get a previewable, editable workflow with 1,000+ app integrations, event triggers, and controllable execution modes.

## Links

- [Home](https://docs.gloriamundo.com/)
- [Main Site](https://gloriamundo.com)
- [Use Cases](https://usecases.gloriamundo.com)

## Overview

GloriaMundo is an AI workflow automation platform. Users describe what they want in natural language and the system generates executable workflows. The platform uses Glass Box transparency: every step can be previewed via Virtual Run before execution. READ actions execute live to fetch data; WRITE actions are simulated until the workflow is run for real.

Saved workflows can either inherit the account default mode by selecting "Default" or explicitly override it with Economy, Balanced, Ultimate, or Custom. The platform connects to 1,000+ apps via managed OAuth, supports multiple accounts for the same service, and can trigger workflows manually, on a schedule, or from a connected-service event subscription.

## Step Types

- **Integration**: Connected-app actions via Composio (Gmail, Slack, Sheets, HubSpot, GitHub, etc.)
- **LLM**: AI reasoning, summarisation, content generation, classification
- **Code**: Custom Python in a secure E2B sandbox
- **Conditional**: Branch workflow based on conditions
- **Sub-Agent**: Spawn a child workflow for complex sub-tasks
- **Browser Automation**: Headless browser for web interactions
- **Web Search**: Search the public web via Tavily/Serper
- **Twitter/X Search**: Search X (Twitter) via Grok native data access
- **URL Extract**: Extract readable content from a specific URL
- **State Get**: Read a value from the cross-run workflow state store
- **State Set**: Write a value to the cross-run workflow state store
- **Vision**: Understand images — objects, scenes, and document content
- **OCR**: Extract text from images, with optional crop region and language hints
- **Structured Extract**: Pull structured fields (JSON) from unstructured text
- **File Output**: Generate a file (text, Markdown, CSV, HTML, or JSON) to Google Drive, optionally emailed
- **Foreach**: Iterate a sub-sequence of steps over a runtime-resolved list
- **Platform Data Query**: Filter, sort, and retrieve rows from an available platform-maintained datastore

Two further capabilities sit outside the step list:

- **Image Generation**: Create images within workflows using Vertex Imagen and OpenRouter models (invoked via model routing, not a workflow step).
- **Document Ingest** (project knowledge): Upload PDFs, Word documents, text files, and images via Graphlit to inform workflow generation. This is retrieval over project documents, not a workflow step — there is no native PDF/DOCX/spreadsheet parsing step.

## Pricing

Start with $10 in free credits, no card required, and they never expire. Subscriptions are Pro ($20/month for $30 of credits) or Max ($50/month for $100); credits roll over and never expire. Platform-billed usage is charged from GloriaMundo credits. If BYOK is enabled, LLM token costs are billed to the user's OpenRouter account at zero markup while service costs continue to use GloriaMundo credits (an active subscription is required for BYOK).

## Pages

### Getting Started
- [Overview](https://docs.gloriamundo.com/getting-started/): Covers workflow modes, creating your first workflow, connecting services, Virtual Run preview, and executing workflows. Includes step-by-step instructions from prompt to execution.
- [Quick Start](https://docs.gloriamundo.com/getting-started/quick-start/): Fast-track guide — sign in, describe workflow, connect apps, preview, run.
- [Your First Workflow](https://docs.gloriamundo.com/getting-started/first-workflow/): Detailed tutorial walking through workflow creation with examples.
- [Connecting Apps](https://docs.gloriamundo.com/getting-started/connecting-apps/): OAuth and API key connections. Covers automatic detection, multiple-account support, service selection, and project documents.

### Building Workflows
- [The Builder](https://docs.gloriamundo.com/workflows/builder/): The main chat interface for workflow creation. Describes prompt input, workflow canvas, and iteration.
- [Workflow Editor](https://docs.gloriamundo.com/features/workflow-editor/): Visual editor for modifying generated workflows — reorder steps, change parameters, add/remove steps.
- [Step Types](https://docs.gloriamundo.com/workflows/step-types/): Detailed reference for every step type — integration, LLM, code, conditional, sub-agent, browser automation, web search, Twitter/X search, URL extract, state get/set, vision, OCR, structured extract, file output, foreach, and platform data query. Each type includes configuration options and examples.
- [Virtual Run (Preview)](https://docs.gloriamundo.com/workflows/virtual-run/): Glass Box preview system. Shows step-by-step execution, generated content, write-action warnings, and cost preview without side effects.
- [Editing Steps](https://docs.gloriamundo.com/workflows/editing-steps/): Modifying parameters, prompts, and configurations of individual steps.
- [Running Workflows](https://docs.gloriamundo.com/workflows/running/): Manual execution, monitoring progress, viewing results.
- [Scheduling & Triggers](https://docs.gloriamundo.com/workflows/scheduling/): Cron schedules and how scheduled polling differs from connected-app event execution.
- [Event Triggers](https://docs.gloriamundo.com/workflows/event-triggers/): Reactive workflows that subscribe to events from connected services such as GitHub, Gmail, Slack, or Google Calendar.

### Features
- [Workflow Generation](https://docs.gloriamundo.com/features/workflow-generation/): How GloriaMundo turns natural language into structured workflows. Covers the pipeline, prompt processing, and step selection.
- [Code Execution](https://docs.gloriamundo.com/features/code-execution/): Secure Python execution in E2B sandboxes. Use for data transformation, calculations, file processing, and custom logic.
- [Browser Automation](https://docs.gloriamundo.com/features/browser-automation/): Headless browser steps for web scraping, form filling, and page interaction.
- [Image Generation](https://docs.gloriamundo.com/features/image-generation/): Generate images within workflows using AI models.
- [Sub-Agents](https://docs.gloriamundo.com/features/sub-agents/): Delegate complex sub-tasks to child workflows that run independently.
- [Knowledge Base](https://docs.gloriamundo.com/features/knowledge-base/): Upload documents, SOPs, and brand guidelines to inform workflow generation.

### Connections
- [Managing Connections](https://docs.gloriamundo.com/connections/overview/): Connect apps via OAuth or API key. Manage active connections, multiple accounts, and default-account fallback.
- [Connection Health](https://docs.gloriamundo.com/connections/health/): Monitor connection status, troubleshoot disconnections, and refresh tokens.

### Approvals
- [Overview](https://docs.gloriamundo.com/approvals/overview/): The approval system that gates write actions. Users review and approve before external changes are made.
- [Approval Modes](https://docs.gloriamundo.com/approvals/modes/): Different approval modes from full manual review to auto-approve for trusted workflows.
- [Managing Approvals](https://docs.gloriamundo.com/approvals/managing/): Reviewing pending approvals, approving/rejecting, and viewing approval history.

### Developer API
- [Overview](https://docs.gloriamundo.com/api/overview/): REST API for programmatic workflow execution. Covers available endpoints and use cases.
- [Authentication](https://docs.gloriamundo.com/api/authentication/): API key management and authentication headers.
- [Executing Workflows](https://docs.gloriamundo.com/api/executing/): POST endpoints for triggering workflow runs with parameters.
- [Polling for Results](https://docs.gloriamundo.com/api/polling/): Check execution status and retrieve results asynchronously.
- [Spend Controls](https://docs.gloriamundo.com/api/spend-controls/): Set budget limits per workflow or per API key.

### Billing
- [Credits & Costs](https://docs.gloriamundo.com/billing/credits/): How billing works — subscription, included credits, BYOK split billing, and usage tracking.
- [Bring Your Own Key (BYOK)](https://docs.gloriamundo.com/billing/byok/): Use your own OpenRouter key, so LLM token costs are billed directly to OpenRouter.
- [Modes & Model Tiers](https://docs.gloriamundo.com/billing/model-tiers/): How workflow modes affect execution tier, cost, and per-workflow overrides.
- [Plans & Credits](https://docs.gloriamundo.com/billing/credit-tiers/): Plans, included credits, and how credits behave (free start, roll over, never expire).

### Integrations
- [Available Apps](https://docs.gloriamundo.com/integrations/overview/): Browse 1,000+ supported apps across email, messaging, social media, CRM, productivity, developer tools, commerce, and more.
- [Connecting Services](https://docs.gloriamundo.com/integrations/): Step-by-step guide to connecting services via OAuth and API keys.

### Settings
- [Overview](https://docs.gloriamundo.com/settings/overview/): Configure memory, safety controls, spending limits, the account default mode, and the OpenRouter Key setting.

### Advanced
- [Approval Controls & Safety](https://docs.gloriamundo.com/advanced/governance/): Exact-name sensitivity-list approvals and their limits.
- [Cognitive Architecture](https://docs.gloriamundo.com/advanced/cognitive-architecture/): How the Router → Solver → Architect pipeline processes prompts into workflows.
- [Memory](https://docs.gloriamundo.com/advanced/memory/): Conversation memory and cross-session context via Zep.
- [Sub-Agent Spawning](https://docs.gloriamundo.com/advanced/subagents/): Advanced configuration for sub-agent delegation, nesting, and resource limits.
- [Multi-Agent Collaboration](https://docs.gloriamundo.com/advanced/collaboration/): Workflows where multiple agents coordinate on complex tasks.
- [Budgets](https://docs.gloriamundo.com/advanced/budgets/): Budget management, spend alerts, and automatic pausing.