Skip to main content

Sharing & Collaboration

Share mock simulations with teammates to collaborate on API configurations. Instead of exporting and re-importing, send an in-app invitation — the recipient accepts and immediately sees the shared simulation in their dashboard.

Overview​

The sharing system has three parts:

  • Invitations — email-based invite flow with accept/decline lifecycle
  • Collaborators — persistent access with permission levels
  • Share Prompts — contextual nudges after simulation creation (with fatigue controls)
Feature Flag

This feature requires the growth_teammate_sharing feature flag to be enabled for your company.

Sharing a Simulation​

  1. Open any simulation from My Simulations
  2. Click the Share button (share icon) on the simulation card or detail page
  3. In the Share Dialog, enter:
    • Email — your teammate's email address
    • Permission — the access level to grant
    • Personal message (optional) — included in the invitation email
PermissionViewEdit RoutesManage Collaborators
ViewerYesNoNo
EditorYesYesNo
AdminYesYesYes
  1. Click Send Invitation

A confirmation banner confirms the invitation was sent.

Managing Collaborators​

Below the invite form in the Share Dialog, the Collaborators section shows everyone with access.

As the simulation owner or an Admin collaborator:

  • Change permission — use the inline dropdown next to a collaborator's name
  • Remove access — click the trash icon to revoke immediately

Viewers and Editors see a read-only list.

Accepting Invitations​

When someone invites you, a banner appears at the top of your dashboard:

  • Single invitation — shows the inviter's name, resource name, and inline Accept / Decline buttons
  • Multiple invitations — shows a count with a Review all link

The full invitations page shows a card per invitation with:

  • Inviter avatar and name
  • Simulation or environment name
  • Permission badge
  • Personal message (if any)
  • Accept and Decline buttons

After accepting, the shared simulation appears in your My Simulations view.

SharedWithBadge​

Shared simulations display a pill badge on their card showing the collaborator count (e.g., "3 collaborators"). This badge appears when at least one collaborator exists beyond the owner.

Limitations​

  • Both users must belong to the same company
  • Invitations expire after 30 days if not responded to
  • Only simulation owners and Admin collaborators can invite new teammates

Next Steps​