What are Organizations?

Organizations in Devin Enterprise are logical groupings that provide structure and boundaries for your development teams. Each organization operates as a self-contained unit with its own shared Devin machine, repository access, and member permissions.

Key Characteristics

Shared Devin Machine: Each organization has its own dedicated Devin machine that all members share. This ensures consistent environment setup and allows team members to collaborate on the same development context. Repository Isolation: All repositories granted to an organization are accessible to all members within that organization. Repository access is managed at the organization level, not per individual user. Member Boundaries: Users can belong to multiple organizations, but their access and permissions are scoped to each organization independently. Billing Separation: Each organization has its own ACU (Agent Compute Unit) limits and usage tracking, enabling clear cost allocation across teams.

Organization Structure

Enterprise Hierarchy

Enterprise Account
├── Organization A (E-commerce Platform)
│   ├── Members: full-stack developers, product managers
│   └── Repositories: web-app, mobile-app, api-service, shared-components
├── Organization B (Analytics Platform)  
│   ├── Members: data engineers, backend developers
│   └── Repositories: data-pipeline, analytics-api, reporting-dashboard
└── Organization C (Infrastructure & Security)
    ├── Members: platform engineers, security engineers
    └── Repositories: infrastructure, deployment-scripts, security-tools

Access Control Flow

  1. Enterprise Admin creates organizations and manages overall enterprise settings
  2. Team Admins invite members to their specific organizations
  3. Members access Devin and repositories within their assigned organizations
  4. Repository permissions are granted by Enterprise Admins to organizations

Planning Your Organization Structure

An effective approach is to map each Devin organization to a GitHub/GitLab team, which often aligns with your Identity Provider (IdP) groups and logical business applications. This provides a systemic way to scale up usage and manage access to repositories.

Example Mapping

GitHub TeamDevin OrganizationIdP GroupBusiness Function
ecommerce-platformE-commerce Platformproduct-ecommerceCustomer shopping experience (web, API, etc)
analytics-platformAnalytics Platformproduct-analyticsData insights and reporting
payments-teamPayments Platformproduct-paymentsPayment processing and billing
platform-infraInfrastructureeng-platformShared infrastructure and security

Decision Framework

When planning your organization structure, consider these factors:

Next Step

Set Up Your First Organization: Learn how to create and configure organizations in your enterprise account to start organizing your development teams.