What is a Workspace?
A workspace provides the foundational architecture for enterprise billing and organizational management. Workspaces act as secure, multi-tenant containers that connect authentication systems (Auth0) with payment processing (Stripe) while providing sophisticated resource allocation and usage tracking capabilities. Key workspace capabilities:- Multi-tenant billing and organizational isolation
- Hierarchical organization structures with usage aggregation
- Enterprise-grade concurrency and reliability features
- Flexible billing models (Single, Assigned, Pooled)
- Integrated member management with role-based access
Workspace Architecture: Foundation for Enterprise Billing
Each workspace represents a complete customer account environment containing all resources needed for billing management, organizational structure, and user administration. Workspaces are engineered for enterprise-scale operations with advanced reliability features.Core Workspace Components
Workspaces consist of four integrated components that work together to provide comprehensive billing and organizational management:Billing Accounts: Financial Management and Payment Processing
Billing accounts manage payment methods, subscriptions, and financial transactions within workspaces. Each billing account connects directly to Stripe for secure payment processing and subscription management. Billing account features:- Secure payment method storage (up to 5 methods)
- Subscription management and resource pooling
- Automated billing and invoice generation
- Multi-currency support for global operations
Organizations: Hierarchical Resource Management
Organizations provide flexible hierarchical structures for modeling business relationships and resource allocation. Support up to 10 levels of nesting with automatic usage aggregation and limit inheritance. Organization capabilities:- Model departments, teams, subsidiaries, or partner networks
- Automatic usage tracking and limit enforcement
- Flexible resource allocation and sharing
- Scalable from simple teams to complex multi-tier structures
Members: Role-Based Access Control
Workspace members provide secure access control with three distinct permission levels for collaborative management:- Owners: Complete workspace control including billing, member management, and configuration
- Admins: Organization management, billing visibility, and member invitation capabilities
- Viewers: Read-only access to workspace data and organizational structures
Billing Modes: Resource Allocation Strategy
Billing modes define how resources and subscriptions are allocated across organizations within your workspace. This permanent configuration choice shapes your workspace’s financial and operational structure:- Single Mode: Unified billing with shared resource pool
- Assigned Mode: Isolated billing accounts for complete separation
- Pooled Mode: Multiple billing accounts contributing to shared resources
Enterprise-Grade Workspace Features
Enterprise Reliability and Performance
Workspaces include advanced reliability features designed for mission-critical enterprise operations:- Idempotent operations: Prevent duplicate processing during network issues
- Distributed locking: Eliminate race conditions in high-concurrency environments
- Atomic transactions: Ensure data consistency across all operations
- Auto-scaling architecture: Handle thousands of concurrent requests
Advanced Resource Management
Sophisticated resource tracking and allocation capabilities for complex organizational needs:- Multi-resource tracking: Users, locations, SSO connections, and custom resources
- Hierarchical limits: Set and inherit limits across organizational levels
- Real-time usage aggregation: Automatic rollup from leaf to root organizations
- Dynamic limit enforcement: Most restrictive limit always applies
Platform Integration Capabilities
Seamless integration with enterprise authentication and payment systems:- Auth0 integration: Connect existing identity management systems
- Stripe integration: Direct payment processing and subscription management
- API-first design: Programmatic access to all workspace functionality
- Dashboard management: Intuitive web interface for administrative tasks
How to Set Up Your Workspace
Follow these steps to configure your workspace for optimal billing and organizational management:- Select Billing Mode: Choose Single, Assigned, or Pooled based on your business requirements (permanent decision)
- Configure Billing Accounts: Connect Stripe customers and add secure payment methods
- Design Organization Hierarchy: Model your business structure using nested organizations
- Add Workspace Members: Invite users with appropriate Owner, Admin, or Viewer roles
- Setup Subscriptions: Configure resource allocations and usage limits for your organizations
What’s Next?
- Learn about Billing Modes to choose the right model for your business
- Explore Modeling Your Business for real-world implementation examples
- Understand Organization Hierarchies for complex structures
- Review System Limitations to plan your implementation