Accounts

Workspaces

View as Markdown

A workspace is the top-level container for sessions, API keys, and billing. When you sign up, you create your first workspace.

Structure

Workspace
  ├── Sessions (created via API key)
  ├── API Keys (created in dashboard)
  ├── Usage Meter (aggregated across all keys)
  └── Balance (prepaid, shared across all keys)

All API keys in a workspace share the same balance and the same session concurrency limits. Usage is tracked per-key in the by_key breakdown of /v1/usage, but the balance is workspace-wide.

Multiple workspaces

You can create additional workspaces from the dashboard. Each workspace has its own:

  • Balance (top up independently)
  • API keys (keys from workspace A cannot access workspace B)
  • Session pool (concurrency limits are per-workspace)
  • Usage history

Use separate workspaces to isolate teams, environments, or projects.

Free tier

Every new workspace starts with 100 MB of free credit. This is enough for testing — roughly 20 sessions of typical use. The free credit never expires and is applied automatically.

Switching workspaces

In the dashboard, use the workspace selector in the top navigation. Switching workspaces changes which sessions, keys, and billing data you see. API requests are scoped by the API key you use, not by a session or cookie.