Skip to content
AlumiaDocs

Search docs

Find pages, headings, and concepts. Press ⌘K or Ctrl+K to toggle.

Projects and workspaces

Organize work into workspaces and projects, each with their own canvas, agents, and shared context.

Open in ChatGPTOpen in Claude

Alumia is multi-tenant by design. Everything lives under an organization, and within an organization you have workspaces and projects.

Organizations

Every signup creates an organization automatically. User-triggered data access is scoped to the authenticated organization and nested writes validate ownership before linking records, so cross-org reads and writes are rejected. You invite teammates and assign roles from the Settings page.

Workspaces

Workspaces are how you group projects and members within an org. Most orgs only need one workspace; larger orgs use them to carve out departments. Ala (the default agent) is visible across every workspace.

Projects

Projects are the unit of work. Each project has:

  • A canvas
  • Its own agents
  • Files, knowledge, memories, datasets, and tasks
  • A primary workspace plus optional shared workspaces (project_workspaces)
  • Project-scoped file browsing rooted at a protected project folder

When in doubt, one project per "thing you're trying to ship." A project is cheap to create and easy to share.

The org Projects and Agents list pages offer card and table views. Table view adds sortable columns and pagination when you manage dozens of projects or agents.

Backup: POST /projects/:id/duplicate, GET /export, and POST /restore (with dryRun) — see Projects API.