Team Workspaces

Create collaborative workspaces for teams and manage simulation sharing, permissions, and member access. Workspaces enable teams to work together on shared mock simulations while maintaining isolation from other teams.

Prerequisites

• An active SureStage account
• Company/organization setup
• Team members already invited to your company

Understanding Workspaces

Workspaces are collaborative environments where:

• Shared Simulations - Team members access the same mock simulations
• Role-Based Access - Control who can view, edit, or manage simulations
• Separate Namespaces - Simulations in one workspace don't conflict with another
• Team Organization - Organize simulations by feature, team, or environment

Types of Workspaces

Type	Purpose	Members	Use Case
Personal	Single user workspace	You only	Individual development
Team	Shared team workspace	Multiple users	Collaborative development
Project	Project-specific workspace	Team members on project	Feature/product development
Environment	Environment workspace	Relevant teams	Dev, staging, production mocks

Creating a Workspace

Create New Team Workspace

1. Go to Workspaces from the main menu
2. Click Create Workspace or New
3. Fill in workspace details:

{
  "name": "Checkout Service",
  "description": "Mock endpoints for checkout feature",
  "type": "team"
}

4. Click Create
5. You're automatically added as owner/admin

Workspace Details

• Name - Descriptive workspace name
• Description - What this workspace is for
• Type - Personal or team workspace

Managing Workspace Members

Add Team Members

1. Open workspace
2. Click Members or Team
3. Click Add Member
4. Search for user by name or email:

Invite: john@company.com
Role: Editor

5. Select role:

   • Owner - Full control, manage members, delete workspace
   • Admin - Full control, manage members (not delete)
   • Editor - Create/edit simulations and responses
   • Viewer - Read-only access to simulations

6. Click Invite

7. User receives invitation notification

8. They accept to join workspace

View Workspace Members

1. Open workspace
2. Click Members tab
3. See list of all members:
   • Name and email
   • Role
   • Joined date
   • Last activity

Update Member Role

Change a member's permission level:

1. Open workspace members
2. Click member's name or options menu
3. Select new role
4. Confirm change

Role hierarchy (from most to least permissions):

• Owner > Admin > Editor > Viewer

Remove Member

Remove a user from workspace:

1. Open workspace members
2. Find member
3. Click Remove or delete icon
4. Confirm removal

Member can no longer access workspace simulations (unless they have direct access elsewhere).

Sharing Simulations to Workspaces

Move Simulation to Workspace

Share a simulation with a workspace:

1. Open simulation
2. Click Settings or gear icon
3. Click Workspace or Sharing
4. Select target workspace:

Current: Personal
Workspace: Checkout Service

5. Confirm move
6. All workspace members now have access

Share Across Workspaces (Future)

In future versions, simulations can be shared to multiple workspaces while remaining owned by one.

Access Control by Role

Viewer Role

Read-only access to instances:

Can:

• View simulations and routes
• View responses and mock data
• Access analytics and reports
• View request logs

Cannot:

• Edit simulations or routes
• Create/modify responses
• Change simulation settings
• Invite members

Use case: QA, product managers, stakeholders who need visibility.

Editor Role

Full editing of instances and content:

Can:

• Create/edit simulations
• Create/modify responses
• Update routes
• Manage mock state
• Create snapshots
• Use chains and workflows

Cannot:

• Manage workspace members
• Change workspace settings
• Delete simulations
• Transfer workspace

Use case: Developers, test engineers building mocks.

Admin Role

Manage workspace and instances:

Can:

• Do everything Editors can do
• Invite/remove members
• Change member roles
• Manage workspace settings
• Archive simulations
• View activity logs

Cannot:

• Delete workspace (Owner only)
• Change workspace owner

Use case: Tech leads, team managers.

Owner Role

Full control:

Can:

• Do everything Admin can do
• Delete workspace
• Transfer workspace ownership
• Manage billing/subscription

Use case: Team lead, workspace creator.

Workspace Settings

Update Workspace Details

1. Open workspace
2. Click Settings
3. Update:
   • Name
   • Description
   • Privacy/visibility settings
4. Click Save

Archive Workspace

Hide a workspace without deleting:

1. Open workspace settings
2. Click Archive Workspace
3. Confirm
4. Workspace is archived and no longer appears in active list
5. Members can no longer access it
6. Data is retained

Delete Workspace

Permanently remove workspace and all simulations:

1. Open workspace settings
2. Click Delete Workspace (Owner only)
3. Type workspace name to confirm
4. Click Delete
5. Workspace and all simulations are permanently deleted
6. Cannot be undone

Warning: This is irreversible.

Workspace Activity and Notifications

View Activity Log

See all changes in the workspace:

1. Open workspace
2. Click Activity or Audit Log
3. View timeline of actions:
   • Who made the change
   • What was changed
   • When it happened
   • Details of change

Example activities:

• User added simulation
• Response updated
• Member invited
• Chain executed
• Settings changed

Member Notifications

Members receive notifications for:

• Invitation to join workspace
• Simulations added to workspace
• Changes to shared simulations (optional)
• Member role changes
• Workspace deletion (if admin/owner)

Common Workspace Patterns

Feature Team Workspace

Organize by feature/product:

Workspace: Payment Processing
Members:
  - Sarah (Owner) - Backend engineer
  - Mike (Admin) - Tech lead
  - Lisa (Editor) - Frontend engineer
  - James (Viewer) - QA engineer

Simulations:
  - payment-service (production-like)
  - payment-webhook (webhook testing)
  - stripe-integration (external API)

Environment-Based Workspaces

Separate workspaces per environment:

Workspace: Development Mocks
  - All services in dev flavor
  - Loose validation
  - Fast execution

Workspace: Staging Mocks
  - Production-like configurations
  - Strict validation
  - Performance expectations

Workspace: Production Mocks
  - Exact API contracts
  - All error scenarios
  - Pinned responses

Cross-Functional Access

Grant access by role:

Workspace: User Service
Owner: Engineering Lead
Editors: Full-stack developers (5 people)
Viewers: Product, QA, DevOps (8 people)

Viewers see simulation configurations without risking accidental changes.

Multiple Teams in Company

Separate workspaces per team:

Company: ACME Corp
├── Workspace: Frontend Team
│   ├── payment-service
│   └── user-service
├── Workspace: Backend Team
│   ├── data-pipeline
│   └── analytics-service
└── Workspace: Mobile Team
    ├── auth-service
    └── push-notification-service

Personal Workspace

Your default personal workspace:

• Automatically created with your account
• Only you have access
• Cannot add members
• Cannot be deleted
• Great for experimentation and drafts

Access: Click Personal in workspace selector.

Invitation Management

Send Invitations

1. Open workspace
2. Click Members > Invite
3. Enter email addresses
4. Select role
5. Click Send Invitations

Invitations are sent via email with acceptance link.

Accept Invitation

Users who are invited:

1. Receive email from SureStage
2. Click Accept Invitation link
3. Are added to workspace with specified role
4. Can immediately access simulations

Pending Invitations

View invitations waiting for acceptance:

1. Open workspace settings
2. Click Pending Invitations
3. See:
   • Email address
   • Invited on date
   • Role
   • Resend or cancel

Cancel Invitation

Remove pending invitation:

1. Click invitation in pending list
2. Click Cancel or Revoke
3. Confirmation
4. Invitation is cancelled
5. User cannot accept it

Troubleshooting

Can't See Workspace

• Verify you're logged in
• Check if workspace was archived
• Confirm you're in the right company/account
• Contact workspace admin if access was revoked

Member Can't Access Simulation

• Verify member was added to workspace
• Check member's role (need at least Viewer)
• Confirm simulation is in this workspace (not personal)
• Try having member refresh page

Can't Invite Member

• Verify member exists in your company
• Check that you have admin/owner role
• Ensure their email is correct
• Verify your company subscription allows more members

Wrong Role Selected for Member

• Open member in workspace
• Click options menu
• Select correct role
• Confirm change takes effect immediately

API Reference

Workspace Management

Method	Path	Description
GET	/workspaces	List your workspaces
POST	/workspaces	Create workspace
GET	/workspaces/:id	Get workspace details
PATCH	/workspaces/:id	Update workspace
DELETE	/workspaces/:id	Delete workspace

Member Management

Method	Path	Description
GET	/workspaces/:id/members	List members
POST	/workspaces/:id/members	Add member
PATCH	/workspaces/:id/members/:userId	Update member role
DELETE	/workspaces/:id/members/:userId	Remove member

Next Steps

• Managing Simulations - Create simulations in workspaces
• Sharing with Snapshots - Share configurations across teams
• Analytics - Monitor team usage
• Roles and Permissions - Learn more about permission models