Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hexelstudio.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Hexel Studio uses a three-level hierarchy to isolate resources and control access.

​
Hierarchy

1

Organization

Your company or team. Contains all users, billing, and workspaces. Each organization is fully isolated from others.
2

Workspace

A project or team within your organization. Use workspaces to separate different products, teams, or use cases.
3

Environment

An isolated context within a workspace. Typically production, staging, and development. Each environment has its own agents, instances, sandboxes, and API keys.

​
What lives where

ResourceScoped to
Users, roles, policiesOrganization
Service users, API keysWorkspace + Environment
Agents, instances, sandboxesEnvironment
Usage records, audit logsOrganization

​
Data isolation

LevelIsolationExample
OrganizationCompleteCompany A cannot see Company B’s data
WorkspaceLogicalTeam Alpha’s agents are separate from Team Beta’s
EnvironmentLogicalProduction agents are separate from development agents

​
Authentication context

Your API key or OAuth client is scoped to a specific workspace and environment. All API calls are automatically routed to the correct context. 
from hexel import Hexel

# The API key determines your org, workspace, and environment
client = Hexel(api_key="your_api_key")

# All operations are scoped automatically
agents = client.compute.agent.list()  # Returns agents in your environment only
You do not need to specify organization, workspace, or environment in API calls.

​
Recommendations

PracticeWhy
One organization per companySimplifies billing and user management
One workspace per project or teamKeeps resources organized
Separate environments for each stagePrevents production and development from interfering
Separate API keys per environmentLimits blast radius if a key is compromised