Organization Model
Understand how enterprise accounts, organization hierarchy, identity, policy, billing, and data residency fit together in Factory.
Factory's organization model lets an enterprise expand Droid across many teams without turning every team into a separate commercial or identity tenant. One enterprise root owns the contract, identity connection, billing relationship, and top-level administration. Organizations under that root provide operating boundaries where teams can manage membership, local admins, settings, credentials, usage limits, and regional posture.
Use this page to design the operating model before creating organizations under the enterprise root. For the step-by-step setup guide, see Organizations. For the management surface, see Admin Console.
Model at a glance
The enterprise root is the top of the Factory hierarchy. It owns the enterprise relationship and can govern the organizations below it. Each organization is an operating boundary inside that relationship.
Core concepts
| Concept | What it means |
|---|---|
| Enterprise root | The top-level organization for the enterprise. It owns the enterprise contract, SSO connection, optional Directory Sync connection, billing account, and enterprise administration. |
| Organization | An operating boundary inside the enterprise hierarchy. It can have its own members, roles, local admins, controls, usage limits, service accounts, and regional settings where root policy allows. |
| Organization path | A slash-delimited label such as Product Delivery/Regulated Workloads. The path is human-readable. Factory also keeps a stable internal ID so renaming a team does not erase its identity. |
| Active organization | The org context a user chooses when working in the app, desktop app, or CLI. New sessions are tied to this selected org for product context and membership behavior. |
| Root attribution | Usage, billing, and commercial attribution roll up to the enterprise root even when work happens in another organization. |
What rolls up to the root
The root keeps the enterprise relationship centralized:
- one enterprise contract and subscription;
- one billing account and invoice;
- one SSO connection;
- one optional Directory Sync connection;
- enterprise-level visibility and administration;
- root-managed controls where the enterprise chooses to enforce them.
Organizations under the enterprise root should not be configured as separate SSO tenants or separate billing accounts. They are hierarchy and governance boundaries inside the same enterprise deployment.
What can differ by organization
Organizations provide separation where teams need different operating rules.
| Area | Can differ by organization |
|---|---|
| Membership and roles | Users can be assigned to one or more organizations with Owner, Manager, or User roles. |
| Local administration | Organization owners and managers can administer their org where root controls allow. |
| Enterprise Controls | Model policy, autonomy ceilings, MCP policy, command rules, sandboxing, retention, and related settings can vary by org unless restricted by root management. |
| Usage limits | Global and per-user limits can be set locally where allowed. Root admins can copy or apply root limits to selected organizations. |
| Region and data residency | An organization can be assigned to a regional deployment at creation. The default is Global. |
| Service accounts and credentials | Automation identities should be scoped to the organization that owns the workflow. |
| Integrations | Integrations are configured at the organization level, so teams can isolate repository, service account, and workflow access. |
Design patterns
Create a separate organization when a group needs a real boundary, not only a label. The strongest signals are different admins, different membership, different credentials, different data residency, different model policy, or different spend controls.
Regional model
Use regional organizations when residency, local administration, or deployment routing differs by geography.
Acme Corp
├── Global Platform
├── Europe
│ └── Regulated Infrastructure
└── North AmericaDeclare the region when creating the organization. Mixing regions in a hierarchy is supported when the enterprise intentionally wants different residency boundaries for different teams.
Regulated workload model
Use a nested organization for high-sensitivity work that needs stricter model access, lower autonomy, tighter command policy, or BYOK / customer-hosted inference.
Acme Corp
└── Product Delivery
├── Standard Workloads
└── Regulated WorkloadsThis lets the regulated group inherit enterprise identity and billing while keeping stricter local controls.
Project or client delivery model
Consulting, agency, and client delivery teams often need a separate boundary per project or client environment.
Acme Consulting
└── Professional Services
├── Project A
│ ├── Client Environment
│ └── Restricted Work
└── Project BUse this pattern when credentials, repositories, or client-specific service accounts should not be shared across projects.
Department-only model, discouraged by default
Avoid mirroring the HR department chart as the default hierarchy. A department branch is useful only when the department itself needs separate administration, membership, credentials, data residency, model policy, or spend controls.
Acme Corp
├── IT
│ ├── Engineering
│ └── Operations
└── FinanceUse this model when those departments share one enterprise contract and SSO connection but truly need different owners, members, service accounts, and policy defaults. If the only difference is reporting, keep the organization structure simpler and use usage exports or analytics instead.
Naming and hierarchy guidance
Keep the hierarchy understandable for Finance, IT, security, and team admins:
- prefer two or three levels unless deeper structure is required;
- use stable names that match how the enterprise already refers to teams;
- avoid creating organizations only for reporting if membership and policy are identical;
- keep sibling names unique and easy to search;
- choose paths that make usage exports and access reviews readable.
Planning worksheet
| Question | Decision to make |
|---|---|
| Who owns the enterprise root? | Identify the enterprise owners who can manage root policy, billing, and identity. |
| Which groups need boundaries? | List teams that need distinct membership, admins, controls, credentials, regions, or limits. |
| Which controls are root-managed? | Decide which Enterprise Controls, usage limits, and membership controls should be read-only for local organization admins. |
| How will membership be managed? | Choose Directory Sync group mapping, UI-based assignment, or a migration period using both. |
| Which regions are required? | Decide whether each organization uses Global or a regional deployment. |
| Where should automation live? | Scope service accounts, integrations, CI, and other machine workflows to the owning organization. |
Related resources
Create organizations, configure membership, and manage user access.
Manage directory, organizations, billing, and identity from the enterprise surface.
Configure model, tool, autonomy, retention, and safety policies.
Configure SSO, Directory Sync, roles, service accounts, and API keys.