Organizations & workspaces

Organization  (billing, RBAC, plan)
└─ Workspace  (isolated data scope)
   └─ Traces + Spans

Organization

The top-level container — subscription plan, members, roles, API keys, integrations.

One is created automatically on signup. Create more from Settings -> Organizations.

Workspace

Isolated data scope inside an org. Use them to separate:

• Environments — prod vs staging vs dev.
• Teams — web, backend, mobile.
• Customers — one workspace per tenant in a multi-tenant SaaS.

Target a workspace from the SDK two equivalent ways:

st.init(workspace_slug="prod")

export STASO_WORKSPACE_SLUG=prod

The default workspace is named default.

When to add a workspace

• Keep staging traffic out of prod dashboards.
• Two teams should not see each other's traces.
• Multi-tenant product with per-customer scoping.

Err on the side of more.

Next

• API keys
• Team and roles