Teams & Workspaces

A workspace is the account. Your credit balance, API keys, sessions, datasets, and billing all belong to a workspace — not to you personally. A user can belong to many workspaces (up to 10), and a workspace can have many members. Everything you do is scoped to your active workspace.

Every member of a workspace shares its credit balance — a charge by one member reduces the balance all members see. Members also share the workspace's API keys' scope, sessions, and datasets. There are two roles: the owner (the member who created the workspace) and admins (everyone else). Admins can run plays, manage data, and invite teammates; the owner additionally handles billing, can remove members, and can delete the workspace. Granular per-member permissions are coming later.

Inviting teammates

From the dashboard Team page, invite a teammate by email. They receive an invitation link that:

is single-use — once accepted it can't be reused,
expires after 24 hours,
is bound to the invited email — it can only be accepted by an account with that email address.

Any member can send or resend an invite (resending refreshes its expiry); only the workspace owner can revoke one. Inviting someone who's already a member returns an error rather than creating a duplicate.

The owner can also remove a member from the Team page — they lose access to the workspace immediately, but keep their own personal workspace (and can be re-invited later).

Invites are managed in the web dashboard. The CLI covers the rest — hyreflow workspace list, create <name>, status, and switch <slug|n|id> (see CLI Concepts).

Accepting an invite

Open the invitation link and sign in (or sign up) with the invited email. You're added to that workspace, and the dashboard opens straight to it. You also get your own personal workspace (every account has one), with the once-per-identity starter credits — so you keep a private workspace alongside the team you joined. Use the switcher to move between them.

Switching workspaces

The dashboard sidebar shows a workspace switcher at the top — click it to see every workspace you belong to and jump between them. Switching changes your active workspace for the session — the balance, keys, sessions, and data you see all follow the switch. You keep your single sign-in; there's no need to log in again per workspace. From the CLI, the equivalent is hyreflow workspace switch <slug> — workspace list shows each workspace's slug (its number or ws_… id work too).

Creating additional workspaces

You can create additional workspaces you own (e.g. to separate clients or teams) up to the 10-workspace limit — click + New workspace in the sidebar switcher (or on the Settings page), or run hyreflow workspace create <name>. A newly created workspace starts at 0 credits — starter credits are once-per-identity (below), not per workspace.

Your personal workspace

Every account owns a personal workspace, created at first sign-in and named after your email — signing up as [email protected] creates "jordan's Workspace". You can rename it any time from the Settings page.

Starter credits are once per person

New accounts start with +25 credits, granted once per identity into your own personal workspace at first sign-in — not every time you join or create one. Signing up through an invite grants those credits to your personal workspace, never to the team you joined (so credits can't be farmed by inviting throwaway accounts). Additional workspaces you create start at 0 credits.

See Credits & Billing for how charges work within a workspace.