# Alumia

> Multi-tenant AI agent platform with a React Flow canvas, peer agent messaging, 37 visible models across 14 providers, and 856 connector slugs.

## Documentation

- [Welcome to Alumia](https://alumia.com/docs.md): Build, deploy, and orchestrate AI agents on a visual canvas.
- [API overview](https://alumia.com/docs/api.md): Base URL, authentication, response envelope, and error model for the Alumia v1 HTTP API.
- [API access](https://alumia.com/docs/api-access.md): Use Alumia agents and platform resources from your own application.
- [Agents](https://alumia.com/docs/api/agents.md): Create, list, update, and delete agents; read peer messages and sessions for a single agent.
- [Authentication](https://alumia.com/docs/api/authentication.md): Mint, use, and revoke API keys for programmatic access to Alumia.
- [Billing](https://alumia.com/docs/api/billing.md): Read org balance, usage, subscription plans, transactions, and deposits.
- [Connectors](https://alumia.com/docs/api/connectors.md): Browse the connector catalog, start OAuth or API-key connections, and manage connection records.
- [Errors](https://alumia.com/docs/api/errors.md): Every error code the API can return, with HTTP status, common triggers, and recovery guidance.
- [Files](https://alumia.com/docs/api/files.md): Upload, list, download, preview, and delete files in org and project storage.
- [Projects](https://alumia.com/docs/api/projects.md): CRUD for projects, the canvas-and-session containers that scope agent work.
- [Sessions](https://alumia.com/docs/api/sessions.md): Chat sessions and messages, including the streaming UI message protocol.
- [Webhooks](https://alumia.com/docs/api/webhooks.md): Inbound webhook receivers, secret rotation, and delivery history.
- [App surface](https://alumia.com/docs/app-surface.md): The dashboard, admin area, canvas, and operational views users work from.
- [Billing](https://alumia.com/docs/billing.md): Subscription plans, org-scoped USD balance, promotional signup credit, and platform fees.
- [Changelog](https://alumia.com/docs/changelog.md): A historical log of recent Alumia development across platform, canvas, and admin surfaces.
- [Changelog Ledger](https://alumia.com/docs/changelog-12-day-ledger.md): Full per-commit stream for the 12-day Alumia rollout (2026-05-02 to 2026-05-14).
- [Concepts](https://alumia.com/docs/concepts.md): Core Alumia mental models for agents, canvases, workspaces, blocks, tools, files, voice, and learning mode.
- [Admin operations](https://alumia.com/docs/concepts/admin-operations.md): Platform administration for governance, telemetry, support workflows, and operational control.
- [Agents](https://alumia.com/docs/concepts/agents.md): AI agents with a system prompt, a chosen model, scoped tools, and managed reliability.
- [Blocks](https://alumia.com/docs/concepts/blocks.md): Structured, typed visual outputs for agent work — DataSpec, MCP Apps, artifacts, and 13 show primitives.
- [Canvas](https://alumia.com/docs/concepts/canvas.md): A visual workspace where agents run, communicate, and emit blocks — with snap-to-grid, smart alignment guides, a minimap, and shareable links.
- [Feedback](https://alumia.com/docs/concepts/feedback.md): User and security feedback in Alumia, including admin triage and notification workflows.
- [Files](https://alumia.com/docs/concepts/files.md): Files in projects — saved to S3, previewed by kind, with a protected project folder at the root.
- [Learning mode](https://alumia.com/docs/concepts/learning-mode.md): Ala learns about you through conversation and stores small typed insights you can review or delete.
- [Memory](https://alumia.com/docs/concepts/memory.md): Long-term context stored in Postgres and recalled per query, scoped to org, project, agent, or session.
- [Peer messaging](https://alumia.com/docs/concepts/peer-messaging.md): Agents communicate as peers. No hierarchy, no swarm coordinator, no parent-child.
- [Projects and workspaces](https://alumia.com/docs/concepts/projects-workspaces.md): Organize work into workspaces and projects, each with their own canvas, agents, and shared context.
- [Sessions](https://alumia.com/docs/concepts/sessions.md): A session is a single agent's conversation history — the unit that holds messages, tool calls, and status.
- [Shop](https://alumia.com/docs/concepts/shop.md): In-app commerce workflows for store browsing, carts, checkout, and order tracking.
- [Tools](https://alumia.com/docs/concepts/tools.md): Capabilities agents can call with scoped access.
- [Voice mode](https://alumia.com/docs/concepts/voice.md): Realtime voice conversations with agents, backed by OpenAI Realtime and per-agent voice profiles.
- [Workspaces](https://alumia.com/docs/concepts/workspaces.md): Optional sub-org grouping for agents, projects, and members. Ala stays visible everywhere.
- [Connectors](https://alumia.com/docs/connectors.md): External services that agents can call as scoped tools.
- [API key connectors](https://alumia.com/docs/connectors/api-keys.md): How API-key connectors store and rotate credentials.
- [Build your own](https://alumia.com/docs/connectors/build-your-own.md): How custom connectors are registered.
- [Commerce & finance](https://alumia.com/docs/connectors/commerce-finance.md): Stripe, Shopify, QuickBooks, HubSpot, Salesforce, and Mercury connectors.
- [Developer tools](https://alumia.com/docs/connectors/developer.md): GitHub, Linear, Asana, Trello, Jira, Sentry, Vercel, Cloudflare, and Supabase connectors.
- [Google Workspace](https://alumia.com/docs/connectors/google-workspace.md): Gmail, Calendar, Drive, Docs, Sheets, Slides, and YouTube connectors.
- [Messaging](https://alumia.com/docs/connectors/messaging.md): Slack, Discord, Telegram, WhatsApp, Twilio, and X connectors.
- [OAuth flow](https://alumia.com/docs/connectors/oauth.md): How OAuth connections work in Alumia and how the chat resumes after consent.
- [Research & data](https://alumia.com/docs/connectors/research-data.md): Open knowledge sources and search APIs for research agents.
- [FAQ](https://alumia.com/docs/faq.md): Common questions about agents, billing, security, and integrations.
- [Getting started](https://alumia.com/docs/getting-started.md): Go from sign-up to your first agent conversation in four steps.
- [Guides](https://alumia.com/docs/guides.md): Task-oriented walkthroughs for building, operating, and integrating with Alumia.
- [API quickstart](https://alumia.com/docs/guides/api-quickstart.md): Generate a key, create a session, and stream an agent reply with curl.
- [Build your first agent](https://alumia.com/docs/guides/build-your-first-agent.md): From sign-up to a working agent reply in the lab in under five minutes.
- [Provider keys](https://alumia.com/docs/guides/byok.md): New provider-key setup is temporarily unavailable while Alumia focuses billing around managed subscription plans.
- [Connect Gmail](https://alumia.com/docs/guides/connect-gmail.md): Wire Gmail through OAuth, attach it to an agent, and have the agent read your inbox.
- [Multi-agent workflow](https://alumia.com/docs/guides/multi-agent-workflow.md): Spawn a peer agent and watch the two coordinate via peer messaging on the canvas.
- [Share a canvas](https://alumia.com/docs/guides/share-canvas.md): Generate a read-only /share/[token] link, control what's visible, and revoke when done.
- [Tool calling](https://alumia.com/docs/guides/tool-calling.md): Give an agent built-in tools and connector-backed tools, and scope what it can do.
- [Top up your balance](https://alumia.com/docs/guides/topup-balance.md): Add USD funds to your org via the in-chat card or the Billing page.
- [Troubleshooting](https://alumia.com/docs/guides/troubleshooting.md): The errors you'll actually hit and exactly what to do about them.
- [Models](https://alumia.com/docs/models.md): The shared model catalog and managed provider boundaries.

## Optional

- [Full documentation bundle](https://alumia.com/llms-full.txt)
- [MCP server](https://alumia.com/docs/mcp): query docs from Cursor or Claude Code