Skip to main content

Team Sync

Team Sync allows you to collaborate with your team by sharing collections, environments, and conduits in real-time.

What is Team Sync?​

Team Sync is Nidra's collaboration feature that enables:

  • Real-time synchronization of collections and requests
  • Shared environments for team-wide configurations
  • Collaborative conduit development
  • Version history and conflict resolution
  • Team member management and permissions

Getting Started​

Prerequisites​

  • Nidra account (create if needed)
  • Team workspace (create or join existing)
  • Internet connection for synchronization

Enable Team Sync​

  1. Open Nidra settings
  2. Go to "Team Sync" section
  3. Sign in with your account
  4. Create a new team or join existing
  5. Enable sync for selected collections

Creating a Team​

  1. Click "Team Sync" in settings
  2. Click "Create Team"
  3. Enter team name
  4. Optionally add team description
  5. Click "Create"
  6. Invite team members

Inviting Team Members​

  1. Go to team settings
  2. Click "Invite Members"
  3. Enter email addresses
  4. Select role (Admin, Editor, Viewer)
  5. Send invitations

Team members will receive email invitations with join links.

Sharing Collections​

Share a Collection​

  1. Right-click a collection
  2. Select "Share with Team"
  3. Choose team
  4. Set permissions
  5. Click "Share"

Permissions​

  • Admin: Full control, can delete
  • Editor: Can modify requests and settings
  • Viewer: Read-only access

Synchronization​

How Sync Works​

  • Automatic: Changes sync in real-time
  • Bidirectional: Updates flow to all team members
  • Conflict resolution: Handles concurrent edits
  • Version history: Track all changes

Sync Indicators​

Nidra shows sync status:

  • Green checkmark: Synced
  • Orange clock: Syncing in progress
  • Red X: Sync error (check connection)
  • Blue dot: Unsynced local changes

Manual Sync​

Force synchronization:

  1. Right-click collection
  2. Select "Sync Now"

Or use the sync button in the toolbar.

Working with Shared Collections​

Making Changes​

  1. Open a shared collection
  2. Edit requests, add new ones, etc.
  3. Changes sync automatically to team
  4. Team members see updates in real-time

Viewing Team Activity​

See what your team is working on:

  1. Open "Team Activity" panel
  2. View recent changes
  3. See who made what changes
  4. Filter by team member or date

Preventing Conflicts​

Best practices:

  • Communicate: Let team know what you're working on
  • Work on different areas: Divide collections by feature
  • Use branches (if supported): Isolate experimental work
  • Sync often: Pull latest changes before making edits

Environment Sharing​

Shared Environments​

Share environments with the team:

  1. Right-click environment
  2. Select "Share with Team"
  3. Choose team
  4. Set read-only or editable
  5. Share

Best Practices​

  • Share base configurations: Common variables all need
  • Keep secrets local: Don't share API keys/passwords
  • Use parent environments: Share parent, customize child locally

Secret Variables​

For sensitive data:

  1. Mark variables as "Secret" in shared environments
  2. Team members set their own values locally
  3. Values don't sync (only variable names)

Conflict Resolution​

When Conflicts Occur​

Conflicts happen when:

  • Two people edit the same request simultaneously
  • You edit while offline, others edit online
  • Multiple people modify collection structure

Resolving Conflicts​

Nidra presents conflict resolution UI:

  1. View your changes
  2. View other person's changes
  3. Choose:
    • Keep yours: Discard remote changes
    • Keep theirs: Accept remote changes
    • Merge: Combine both (when possible)
  4. Confirm resolution

Avoiding Conflicts​

  • Sync frequently
  • Communicate with team
  • Work on different parts of collections
  • Use locking (if supported)

Version History​

Viewing History​

See all changes to a collection:

  1. Right-click collection
  2. Select "Version History"
  3. Browse timeline of changes
  4. See who made each change

Restoring Previous Versions​

Undo mistakes:

  1. Open version history
  2. Find the version to restore
  3. Click "Restore"
  4. Confirm

All team members will receive the restored version.

Offline Mode​

Working Offline​

You can work without internet:

  • Make changes to synced collections
  • Changes are queued locally
  • When online, changes sync automatically

Sync on Reconnect​

When internet returns:

  1. Nidra detects connection
  2. Pushes local changes
  3. Pulls remote changes
  4. Resolves conflicts if needed

Team Management​

Roles and Permissions​

Team Owner:

  • Full control over team
  • Manage members
  • Delete team

Admin:

  • Invite/remove members
  • Manage shared collections
  • Change permissions

Editor:

  • Edit shared collections
  • Create new requests
  • Cannot manage team

Viewer:

  • View shared collections
  • Cannot edit
  • Can duplicate to personal collections

Changing Roles​

  1. Go to team settings
  2. Find team member
  3. Click role dropdown
  4. Select new role
  5. Save

Removing Members​

  1. Go to team settings
  2. Find member to remove
  3. Click "Remove"
  4. Confirm

They lose access immediately.

Best Practices​

Organization​

  • Create teams by project: Don't mix unrelated work
  • Use clear naming: Help team find collections easily
  • Document collections: Add descriptions for context
  • Regular cleanup: Archive old collections

Security​

  • Don't share secrets: Keep credentials local
  • Use viewer role: For people who only need to see
  • Review permissions: Regularly audit who has access
  • Remove former members: Promptly when they leave

Collaboration​

  • Communicate: Use team chat or comments
  • Establish conventions: Agree on naming, structure
  • Review changes: Check team activity regularly
  • Merge carefully: Resolve conflicts thoughtfully

Performance​

  • Limit sync scope: Don't sync everything
  • Prune history: Archive old versions
  • Monitor storage: Keep team usage reasonable

Troubleshooting​

Sync Not Working​

Check:

  • Internet connection
  • Login status (signed in?)
  • Team permissions (do you have access?)
  • Nidra version (update if needed)

Changes Not Appearing​

  • Force manual sync
  • Check conflict resolution queue
  • Verify you're looking at shared collection
  • Restart Nidra

Can't Share Collection​

  • Verify team membership
  • Check collection ownership
  • Ensure no naming conflicts
  • Review team storage limits

Advanced Features​

Share view-only links to anyone:

  1. Right-click collection
  2. Select "Get Public Link"
  3. Share URL with stakeholders
  4. They can view without account

API Documentation​

Generate public API docs from collections:

  1. Mark collection as documentation
  2. Add descriptions and examples
  3. Publish as public docs
  4. Share URL with external developers

Webhooks​

Get notified of team changes:

  1. Team settings → Webhooks
  2. Add webhook URL
  3. Select events (collection changed, etc.)
  4. Your system receives notifications

Migration​

From Solo to Team​

Convert personal collections to team:

  1. Create team
  2. Share personal collections with team
  3. Invite team members
  4. Transfer ownership if needed

Between Teams​

Move collections:

  1. Export from current team
  2. Import to new team
  3. Update environment references
  4. Share with new team members

Next Steps​