Workspaces and members

Create workspaces, choose their region, invite members, accept invitations, assign roles, transfer ownership, and see exactly what each role can do in the TestRelic Console.

A workspace is the unit everything in the Console belongs to: members, API keys, credit balance, billing, usage, logs and settings. Workspaces don't share credit or keys. Some messages call a workspace an organization; it's the same thing.

Workspaces

Create a workspace

Any member can create a workspace from the workspace switcher (Create workspace) or from Settings → Workspaces → New workspace.

FieldRules
Workspace name2–64 characters.
RegionN. Virginia (us-east-1, United States). Dublin (Ireland) and Mumbai (India) are coming soon: "<region> is coming soon. Pick us-east-1 for now."

Request logs, usage and billing records stay in the workspace's region. Inference runs in US data centres. The region can't be changed after the workspace is created.

You become the new workspace's Owner. It starts with a $0 balance and goes through onboarding. You can own up to 10 workspaces ("You can own up to 10 workspaces.").

Switch workspaces

Open the switcher at the top of the sidebar and pick a workspace. The Console reloads on its Overview. Settings → Workspaces lists every workspace you belong to with its region, your role, active API keys, members and monthly spend limit; Open switches to it, Manage opens the current one's settings.

Deleting a workspace, leaving one, and deleting your account aren't available in the Console. Contact TestRelic support (quote your Workspace ID from Settings → General).

Members

Settings → Members lists everyone in the workspace and every pending invitation: name (or "Invite pending"), role, status, when they joined and when they were last active.

Invite people

In Invite by email, enter one or more addresses separated by commas, spaces or semicolons (up to 20 at a time).

Pick a Role: Admin, Developer (default), Billing or Viewer. To make someone an Owner, invite them with another role, then change it once they've joined.

Click Send invites. You see "Invited N people. Invites last 14 days." People who are already members are skipped.

Each person gets an email titled "<inviter> invited you to <workspace> on TestRelic Console" with an Accept invitation button. They sign in with their TestRelic account (using the invited address); they're never asked for payment details.

If the workspace limits invite domains (Settings → Security and SSO → Invite domains), other addresses are refused: "This workspace only invites addresses at @example.com. Not allowed: …".

Pending invitations show Invited, with "Email sent <time>", "Email not sent" or "No email sent". Use Resend (or Retry email) to send it again; you can't resend within a minute ("Invite email sent less than a minute ago."). Cancel invite withdraws it.

Accept an invitation

  • If you don't belong to any workspace yet, signing in with the invited, verified address puts you straight into the workspace.
  • If you already belong to a workspace, open the workspace switcher: the Invitations section lists every pending invitation for your verified email, and a banner across the top of the Console reminds you. Click Accept to join and switch to that workspace, or Decline to dismiss it.

Invitations expire after 14 days. Ask for a new one if yours has expired.

Invitations only show up for a verified email address on your TestRelic account. If you don't see one you're expecting, check that the invite went to that address, then sign out of the Console and back in. Accepting also checks the workspace's current rules: if it has since limited invite domains to exclude your address, or you already own 10 workspaces and the invite is for Owner, the invitation can't be accepted.

Change a role

Use the role dropdown on a member's row. Admins can set Admin, Developer, Billing or Viewer. Only Owners can make someone an Owner or change an Owner's role.

Transfer ownership

A workspace can have more than one Owner. To hand a workspace over:

  1. An Owner sets the new person's role to Owner and confirms.
  2. The original Owner changes their own role (for example to Admin) and confirms that they're stepping down.

Both steps ask for confirmation. A workspace always needs at least one Owner: when you're the only one, your row is locked and labelled Only owner, and the API refuses with "An organization needs at least one owner." You can't remove yourself from the Members table; ask another Owner or Admin.

Remove a member

Remove takes away their access immediately: "<email> loses access to this organization immediately. API keys they created keep working until revoked." Review API keys and revoke theirs if needed.

Roles

OwnerAdminDeveloperBillingViewer
View every page: keys list, logs with bodies, usage, billing, audit log, webhooks✓✓✓✓✓
Create, edit and revoke API keys✓✓✓
Turn MCP tools on or off✓✓✓
Run the Playground (both models), keep Playground history, Warm up now✓✓✓
Billing details, top-ups, coupons, auto top-up, spend limit, payment method✓✓✓
Invite, resend, change roles (except Owner), remove members✓✓
Workspace settings (General, Security and SSO, Data and privacy), webhooks, delete request logs✓✓
Grant the Owner role, change or remove an Owner✓
Create a workspace, switch workspaces, join a waitlist, MCP Test connection✓✓✓✓✓

In short: Owner can do everything; Admin everything except managing Owners; Developer keys, Playground and MCP, plus read; Billing the billing pages, plus read; Viewer read only.

When your role can't do something, the control is disabled with "Your role can't change this. Ask an admin.", and the API answers "Your role (<role>) cannot do that."

Was this page helpful?

On this page