Workspaces
Workspace Overview
Understand workspaces as the foundation of billing and organizational management, connecting user authentication with payment processing while providing resource management and usage tracking.
A workspace is the foundation of our billing system, think of it as your company’s complete billing and organizational container. It serves as a crucial middleware layer that seamlessly connects your user authentication (managed by Auth0) with payment processing (handled by Stripe), while providing robust resource management and usage tracking.
What is a Workspace?
A workspace represents a single customer account and contains everything needed to manage billing, organizations, and users. It’s designed for high-concurrency environments with built-in mechanisms for idempotency and race condition avoidance, ensuring reliable operations even under heavy load.Core Components
Billing Accounts
Financial entities that hold payment methods and subscriptions. Each billing account is uniquely identified by its Stripe Customer ID and handles all monetary transactions.Organizations
Hierarchical structures representing groups within your workspace that consume resources. They can model anything from departments and teams to franchises and reseller networks.Members
Users with different access levels who can manage various aspects of the workspace:- Owners: Full control over workspace, billing, and members
- Admins: Manage organizations, view billing, invite members
- Viewers: Read-only access to workspace data
Billing Modes
The permanent configuration that determines how subscriptions and resources are allocated across your organizations. Choose from:- Single: One billing account for the entire workspace
- Assigned: Separate billing accounts for different organizations
- Pooled: Multiple billing accounts contributing to a shared resource pool
Key Features
Enterprise-Grade Reliability
- Idempotency: Prevents duplicate operations when network issues cause retries
- Race Condition Prevention: Ensures consistent state even with concurrent operations
- High Concurrency Support: Built to handle thousands of simultaneous requests
Flexible Resource Management
- Track multiple resource types (users, locations, SSO integrations)
- Set limits at any organizational level
- Automatic usage aggregation up the hierarchy
Seamless Integration
- Auth0 Integration: Connects with your existing authentication system
- Stripe Integration: Direct connection for payment processing
- Dashboard Access: Easy management through the web interface
Getting Started
To begin using workspaces effectively:- Choose Your Billing Mode: Select the mode that best fits your business structure (this choice is permanent)
- Set Up Billing Accounts: Connect your Stripe customers and add payment methods
- Create Organizations: Model your business structure with our hierarchical system
- Invite Team Members: Add users with appropriate roles
- Configure Subscriptions: Set up the resources your organizations need
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