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). Everything you do is scoped to your active workspace.

Unlimited members

Every plan, including Free, allows unlimited members in a workspace. There are no seats to buy: adding teammates never changes the plan price. Members share the workspace's credits and plan features, and the owner can give each member a spend cap (see Inviting teammates).

Members share everything in the 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 members (everyone else). Members can run plays and manage data, and see the balance and what was spent on the Usage page. The Billing and Settings pages are the owner's: only the owner manages billing (buying credits, changing or canceling the plan, cards and invoices, auto top-up, spend caps, promo codes), invites teammates and sets their spend caps, can remove members, and can delete the workspace. Integrations act for the whole workspace, so members see the Integrations page but only the owner can connect, change or remove one. Members add their own key for Spott (see Personal keys). Granular per-member permissions are coming later.

Personal keys

Spott records every note, list and update under whoever owns the key that made the change. If your whole team shared one key, everything would look like it came from one person, and per-recruiter reporting would stop working. So in Spott, each member uses their own key, and what they do through Hyreflow shows up under their name.

Add your key

1. Create an API key in Spott, under Settings → API.
2. In Hyreflow, open Integrations and click Add your key next to Spott.
3. You'll see your email with a box next to it. Paste your key there and click Save. Hyreflow checks the key with Spott before saving it.

To stop using it, open the same dialog and click Remove.

Who can see what

• Your key is yours. Nobody else in the workspace can see it, change it or use it, including the owner.
• The workspace key is the owner's own key. The owner connects it under Connect or Manage and doesn't add a separate personal key. Members can't see it, change it or test it. They only see whether the tool is connected.
• Until you add your key, Spott won't run for you. Members never use the workspace's Spott key.
• Scheduled and workflow runs use the workspace key.
• If you're removed from the workspace, your personal keys are deleted.

Which tools support it

Spott, for now. Other tools still run on the workspace key for every member.

Inviting teammates

From the dashboard Settings page, the owner clicks Invite team member and enters one email address per row. Add adds another row, and pasting a list of addresses into an email field (one per line, or separated by commas or semicolons) fills a row for each. The owner can also set an optional spend cap per row. Invite team members sends them all. Any row that couldn't be sent, such as an invalid address, stays in the dialog with the reason so you can fix it and send again. Each invitee receives 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.

The owner can resend an invite (resending refreshes its expiry) or 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 Settings page, they lose access to the workspace immediately, but keep any workspace of their own (and can be re-invited later).

Accepting an invite

Open the invitation link and sign in (or sign up) with the invited email. You're added to that workspace. A new account first sees a short setup page: your name, your role, and how to connect hyreflow to your assistant (the one the workspace owner picked is shown first). Then the dashboard opens on the team's workspace. No personal workspace is created for you. If you want one of your own, click + New workspace in the sidebar switcher; your once-per-identity starter credits land there.

Joining your company's workspace

When you sign up without an invite using a work email, and colleagues on the same email domain already use hyreflow, you don't get a workspace straight away. Instead you see their workspaces, and whether each is on a paid plan (a paid one is marked Recommended). Click Request access and the workspace owner gets an email. The page then confirms the request was sent, and shows that confirmation each time you sign in until the owner answers. If they approve, you get an email saying so with an invite link: open it to join the team. If you would rather start fresh, click Create my own workspace before requesting. Personal email domains (Gmail, Outlook and similar) are skipped: those signups, and work emails with no colleagues on hyreflow yet, get their own workspace right away.

Only workspaces owned by a colleague on your domain are listed. Signing in from the CLI or connecting an MCP client before you've chosen opens the same page, then carries on once you create your workspace.

The owner sees pending requests under Settings → Requests, and a badge with the count appears on Settings in the sidebar. Approve sends the requester an invite; Dismiss request closes it and emails them that it wasn't approved, and they can't ask that workspace again for 14 days. A request nobody answers expires after 14 days with the same email. Either way, their next sign-in shows the workspace list again, so they can create their own.

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, unless you have never received your starter credits (below), which are once-per-identity, not per workspace.

Deleting a workspace

Only the workspace owner can delete it. On the Settings page, click Delete workspace and type DELETE to confirm (pasting is disabled). The workspace is permanently deleted 7 days later, with its data, API keys, MCP connections, and members. Until then it keeps working as normal for everyone, so use up the remaining credits: they are lost with the workspace and are not refunded. While the deletion is scheduled, the workspace can't buy credits or a plan and automatic top-up is paused; cancel the deletion first if you need more. It also still counts toward the 10-workspace limit until it is deleted.

Changed your mind? Settings shows the deletion date and time with a Cancel deletion button, available to the owner any time before then. The day before the deletion, the owner also gets an email with the date, the credits left, and a link to cancel. If the workspace was your last one, your account is deleted with it. If the workspace still picks up a paid plan or a payment before the date (an overdue invoice, say, or a plan resumed from the billing portal), the deletion is called off and the workspace stays.

A workspace on a paid plan can be deleted once you've cancelled the plan (cancel from Billing; for a plan assigned by Hyreflow, contact support).

Your personal workspace

Signing up without an invite creates a personal workspace named after your email (unless your colleagues already use hyreflow, see above), signing up as [email protected] creates "jordan's Workspace". You can rename it any time from the Settings page. Signing up through an invite creates none. If you own no workspace while you're on a team, signing in opens that team instead of creating a new empty workspace.

Starter credits are once per person

New accounts start with +25 credits, granted once per identity into a workspace you own: your personal workspace at first sign-in, or, if you signed up through an invite, the first workspace you create. They are never granted to a team you joined (so credits can't be farmed by inviting throwaway accounts). Any further workspaces you create start at 0 credits. If a colleague on your company email domain already owns a workspace on a paid plan, no starter credits are granted, even if that plan is canceled later: ask to join theirs instead. Joining any workspace on a paid plan also uses them up for good. The monthly Free top-up is skipped while your company domain has a workspace on a paid plan.

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