Skip to main content

How to Get Access to a Workspace

This tutorial guides you through obtaining workspace access based on your role and scenario.

TeamAI avatar
Written by TeamAI
Updated this week

Overview

Whether you're a new team member receiving an invitation or an administrator granting access, you'll find the correct workflow for your situation.

Learning Objectives:

  • Identify your appropriate access path

  • Accept workspace invitations and complete setup

  • Request access when invitation isn't available

  • Grant user access as an administrator

  • Troubleshoot common access issues

Prerequisites

You'll Need:

  • Corporate or personal email address

  • Invitation from workspace admin OR approved access request

  • Web browser and internet connection

  • Multi-factor authentication method (if required)

Determine Your Access Path

Choose Your Workflow

Important: Do not create multiple accounts with different emails—this creates access conflicts.


Accept Email Invitation (New Users)

Complete Setup

  1. Open invitation email from workspace admin

  2. Click "Accept Invitation" link

  3. Create account or sign in:

    • New users: Click "Create Account" → Enter name → Set password (12+ characters)

    • Existing users: Click "Sign In" → Use current credentials

  4. Complete profile (photo, display name)

  5. Accept workspace terms

  6. Set up multi-factor authentication (if required)

Result: You gain full workspace access with appropriate permissions.

Security Advisory: Invitation links expire after 7 days. If expired, request resend from admin.


Request Access Without Invitation

Submit Access Request

Note: Each organization establishes its own process for requesting platform access. Since workspace administrators own their workspaces and control user additions, we suggest the following standardized approach:

  1. Identify workspace admin or owner

    • Ask colleagues who manages workspace access

    • Check company directory, intranet, or IT help desk

    • For enterprise accounts, consult centralized access request portal

  2. Submit formal access request via email

  3. Wait for admin approval

  4. Once invited, follow Received invitation email steps

Result: Request enters approval queue; you'll receive invitation upon approval.

Application: Adapt this workflow to align with your organization's existing access request procedures, ticketing systems, or approval hierarchies.

Note: Enterprise environments may require manager approval before admin grants access—factor this into timeline expectations.

Alternative: Self-Service Signup (If Enabled)

  1. Navigate to https://[workspace-name].teamai.com/signup

  2. Complete signup form

  3. Wait for approval notification

Result: Account created; admin approval may be required before access granted.


Accept Workspace Invitation (Existing Users)

Add New Workspace to Account

  1. Sign in to existing workspace

  2. Click profile avatar (top-right) → Select "Settings"

  3. Click "Workspaces" tab → Click "Join New Workspace"

  4. Enter invitation code from admin OR accept pending invitation from list

  5. Select role → Configure notification preferences → Click "Complete"

Result: New workspace appears in workspace selector dropdown (top-left).


Request Permission Upgrade

Change Role Level

  1. Check current role: Click profile avatar → "View Profile"

  2. Contact workspace admin (find admin list in Settings → Users)

  3. Request upgrade including current role, requested role, and why needed

  4. Wait for confirmation email

  5. Sign out and back in → Verify new permissions

Result: Account updated with elevated permissions.


Grant Access as Administrator

Send Invitations

  1. Access settings: Click "Settings" (left panel) → Select "Users & Permissions"

  2. Click "Invite User" → Enter user's email

  3. Select role:

    • Viewer: View-only access

    • Editor: Create agents, modify datastores

    • Admin: Full workspace management

  4. Click "Send Invitation"

Result: Invitation email sends to user.

Security Advisory: Verify email is correct before sending. Use corporate emails for business workspaces.


Troubleshoot Access Issues

Invitation Link Expired

Resolution: Contact admin → Request resend → Accept within 7 days

Wrong Workspace Accessed

Resolution: Click workspace selector (top-left) → Choose correct workspace from list

Permission Denied Error

Resolution: Check role in profile → If wrong, request upgrade → If correct, action requires higher permissions

Account Already Exists

Resolution: Click "Sign In" instead → Use "Forgot Password" if needed → Follow Accept Workspace Invitation (Existing Users)

Best Practices

  1. Use corporate email for business workspaces

  2. Bookmark workspace URL to prevent phishing

  3. Accept invitations promptly (within 7 days)

  4. Never share credentials—each user must have individual account

  5. Verify email sources before clicking links

Common Questions

Q: How long does access take?
A: With invitation: immediate after setup. With request: 1-3 business days.

Q: Can I join multiple workspaces?
A: Yes—use workspace selector dropdown (top-left) to toggle between them.

Q: What's the difference between roles?
A: Viewer: View only. Editor: Create agents, modify datastores. Admin: Full control.

Q: Can I change my email?
A: Yes—Profile → Email → Change Email (requires verification).

Q: How do I know if I'm an admin?
A: Settings → Users & Permissions visible = you're an admin.

Q: What if I deleted the invitation?
A: Contact issuer to resend or ask for manual invitation code.

Q: Can I remove myself from a workspace?
A: Yes—Settings → Workspaces → Click "Leave" (permanent action).

Q: Do I need separate logins per workspace?
A: No—single login provides access to all workspaces where you're a member.

Did this answer your question?