Skip to main content
Hexel Studio uses a hierarchical multi-tenant architecture to provide isolation, security, and flexibility.

​
Hierarchy

Organization
├── Workspace 1
│   ├── Environment (Production)
│   │   ├── Knowledge Stores
│   │   ├── Memory Stores
│   │   └── Data Sources
│   └── Environment (Development)
│       ├── Knowledge Stores
│       ├── Memory Stores
│       └── Data Sources
└── Workspace 2
    └── Environment (Production)
        └── ...

​
Organization

An Organization is the top-level container representing your company or team.
  • Unique identifier (e.g., org_abc123)
  • Billing and subscription management
  • User management and access control
  • Multiple workspaces

​
Workspace

A Workspace is a project container within an organization.
  • Group related resources together
  • Separate projects or teams
  • Share resources within a workspace

​
Environment

An Environment provides isolation for different stages of development.
  • Production - Live workloads
  • Development - Testing and development
  • Staging - Pre-production testing
Each environment has its own:
  • Knowledge Stores
  • Memory Stores
  • Data Sources
  • API keys

​
How It Works with the SDK

Your API key contains your org, workspace, and environment context. The SDK extracts these automatically: 
from hx import Client

client = Client()

# These are extracted from your API key
print(client.org_id)         # org_abc123
print(client.workspace_id)   # ws_xyz789
print(client.environment_id) # env_prod
You don’t need to specify org/workspace/environment in API calls - they’re determined by your API key.

​
Data Isolation

LevelIsolationDescription
OrganizationCompleteNo data sharing between orgs
WorkspaceLogicalSeparate namespaces within org
EnvironmentLogicalSeparate dev/staging/prod data

​
Best Practices

  1. One org per company - Don’t create multiple orgs for the same company
  2. Workspaces for projects - Separate different projects or teams
  3. Environments for stages - Use dev/staging/prod environments
  4. Separate API keys - Use different keys for each environment