Team Management

Learn how to invite team members, manage permissions, and collaborate effectively on Parslinks.

Overview

Team management in Parslinks allows you to:

• Invite team members to your organization
• Assign roles and permissions
• Control project access
• Collaborate on deployments
• Track team activity

Team Roles

Parslinks has four main roles with different permissions:

Owner

Full control of the organization

Permissions:

• ✅ All admin permissions
• ✅ Delete organization
• ✅ Transfer ownership
• ✅ Manage billing and subscriptions
• ✅ Cannot be removed (only transferred)

Limits:

• 1 owner per organization
• Can transfer ownership to another member

Admin

Manage organization and projects

Permissions:

• ✅ Create/delete projects
• ✅ Invite/remove team members
• ✅ Manage all project settings
• ✅ Deploy projects
• ✅ View billing (limited modifications)
• ✅ Configure organization settings
• ❌ Cannot delete organization
• ❌ Cannot transfer ownership

Use cases:

• Team leads
• Technical managers
• Senior developers

Member

Work on projects

Permissions:

• ✅ View projects
• ✅ Create new projects
• ✅ Deploy projects they have access to
• ✅ Edit project settings (with access)
• ✅ View deployment logs
• ✅ Manage environment variables (with access)
• ❌ Cannot invite team members
• ❌ Cannot delete projects (unless owner)
• ❌ Cannot view billing

Use cases:

• Developers
• Designers
• Content creators

Viewer

Read-only access

Permissions:

• ✅ View projects
• ✅ View deployments
• ✅ View deployment logs
• ✅ View analytics
• ❌ Cannot deploy
• ❌ Cannot edit settings
• ❌ Cannot create projects
• ❌ Cannot view environment variables

Use cases:

• Stakeholders
• Clients
• QA testers
• Read-only access needs

Permission Matrix

Inviting Team Members

Via Dashboard

1. Navigate to Team Page

   • Go to Team in sidebar
   • Click Invite Member

2. Enter Details

   Email: [email protected]
   Role: Member
   Project Access: All Projects

3. Customize Access (optional)

   • Select specific projects
   • Set expiration date
   • Add welcome message

4. Send Invitation

   • Click Send Invite
   • Invitation email sent immediately

Via CLI

# Invite a member
parslinks team invite [email protected] --role member

# Invite with specific projects
parslinks team invite [email protected] --role member --projects "proj1,proj2"

# Invite as admin
parslinks team invite [email protected] --role admin

Via Email Link

Share a join link:

1. Go to Team → Invite Link
2. Generate link
3. Set role and expiration
4. Share link with team members

https://parslinks.com/invite/abc123xyz
Valid for: 7 days
Role: Member

Managing Team Members

View Team Members

See all organization members:

┌─────────────────────────────────────────────────────┐
│ Name          Email              Role    Last Active │
├─────────────────────────────────────────────────────┤
│ John Doe      [email protected]   Owner   2 hours ago│
│ Jane Smith    [email protected]   Admin   1 day ago  │
│ Bob Johnson   [email protected]    Member  Just now   │
│ Alice Brown   [email protected]  Viewer  3 days ago │
└─────────────────────────────────────────────────────┘

Edit Member Role

Change a member's role:

1. Find the team member
2. Click ⋮ → Change Role
3. Select new role
4. Confirm change

Changes take effect immediately.

Remove Team Member

Remove a member from the organization:

1. Find the team member
2. Click ⋮ → Remove Member
3. Choose whether to transfer their projects
4. Confirm removal

Effects:

• Loses access to all organization resources
• Projects they own are transferred or deleted
• Active sessions terminated
• Can be re-invited later

Suspend Member

Temporarily suspend access:

1. Find the team member
2. Click ⋮ → Suspend
3. Add reason (optional)
4. Confirm suspension

Effects:

• Cannot login
• Retains data and projects
• Can be reactivated
• Counts toward team member limit

Project-Level Access

Control which projects team members can access.

Assign Project Access

1. Go to Project Settings → Team

2. Add Member

   • Select team member
   • Choose access level
   • Save changes

3. Access Levels:

   Admin: Full project control
   Write: Deploy and edit settings
   Read: View only

Access Control Matrix

Bulk Access Management

Assign multiple members at once:

1. Go to Project Settings → Team
2. Click Bulk Add
3. Select members
4. Choose access level
5. Apply to all

Inheritance

Members inherit organization-level permissions:

Organization Admin → Project Admin (all projects)
Organization Member → No automatic project access
Organization Viewer → Project Read (all projects)

Team Collaboration Features

Comments on Deployments

Leave comments on deployments:

1. Go to deployment details
2. Scroll to Comments
3. Add comment
4. Mention team members with @username
5. Post comment

Example:

@jane Can you review this deployment?
The new feature is ready for testing.

Deployment Approvals

Require approval before deploying to production:

1. Go to Project Settings → Deployments
2. Enable Require Approval
3. Select approvers
4. Save settings

Workflow:

1. Developer triggers deployment
2. Awaits approval
3. Approver reviews and approves/rejects
4. Deployment proceeds or is cancelled

Notifications

Get notified about team activity:

Notification Types:

• New deployment
• Deployment failed
• Deployment completed
• Comment mentions
• Approval requests
• Team member added/removed

Notification Channels:

• Email
• Slack
• Discord
• Webhooks

Activity Log

Track all team activity:

[2024-01-15 14:30] John deployed to production
[2024-01-15 14:25] Jane updated environment variables
[2024-01-15 14:20] Bob added custom domain
[2024-01-15 14:15] Alice invited new team member

Filter by:

• Team member
• Action type
• Date range
• Project

Team Settings

Team Policies

Configure organization-wide policies:

Two-Factor Authentication

Require 2FA for all team members:

1. Go to Settings → Security
2. Enable Require 2FA
3. Set grace period (e.g., 7 days)
4. Save settings

Members must enable 2FA or lose access.

Password Policy

Set password requirements:

✅ Minimum 12 characters
✅ Require uppercase letter
✅ Require number
✅ Require special character
✅ Prevent password reuse

Session Management

Configure session settings:

Session Timeout: 30 days
Idle Timeout: 2 hours
Concurrent Sessions: 5

IP Allowlist

Restrict access by IP address:

1. Go to Settings → Security
2. Enable IP Allowlist
3. Add allowed IPs:

   203.0.113.0/24    Office Network
   198.51.100.50     VPN Server

4. Save settings

Members can only access from allowed IPs.

Single Sign-On (SSO)

Enable SSO for team login (Team plan+):

Supported Providers:

• Google Workspace
• Microsoft Azure AD
• Okta
• Auth0
• OneLogin
• Custom SAML 2.0

Configuration:

1. Go to Settings → Authentication
2. Click Configure SSO
3. Choose provider
4. Follow setup instructions
5. Test and enable

Benefits:

• Centralized authentication
• Automatic provisioning
• Enhanced security
• Better compliance

Team Analytics

Team Activity Metrics

Track team productivity:

Deployments This Month: 142
─────────────────────────────
John:    45 deployments
Jane:    38 deployments
Bob:     32 deployments
Alice:   27 deployments

Average Build Time: 3m 24s
Success Rate: 94%

Individual Metrics

View per-member statistics:

Member: Jane Smith
─────────────────────────────
Deployments: 38
Success Rate: 97%
Avg Build Time: 2m 45s
Projects: 7
Last Active: 2 hours ago

Project Activity

See who's working on what:

Project: my-app
─────────────────────────────
Most Active: John (12 deploys)
Last Deploy: Jane (2h ago)
Contributors: 4 members

Team Limits by Plan

Best Practices

1. Use Least Privilege

Give minimum necessary permissions:

✅ Viewer for stakeholders
✅ Member for developers
✅ Admin for team leads
✅ Owner for executives

2. Regular Access Reviews

Review team access quarterly:

• Remove inactive members
• Update roles as needed
• Verify project access
• Audit permissions

3. Onboarding Checklist

For new team members:

☐ Send invitation
☐ Assign appropriate role
☐ Grant project access
☐ Share documentation
☐ Add to communication channels
☐ Schedule onboarding call

4. Offboarding Checklist

When members leave:

☐ Remove from organization
☐ Transfer their projects
☐ Revoke API tokens
☐ Update shared credentials
☐ Remove from communication channels
☐ Export their work if needed

5. Communication

Set up team communication:

• Slack/Discord integration
• Deployment notifications
• Regular team syncs
• Document processes

Troubleshooting

Invitation Not Received

Solutions:

• Check spam folder
• Verify email address
• Resend invitation
• Use invite link instead

Cannot Remove Member

Reasons:

• Member is the owner (transfer ownership first)
• You lack permissions
• Member has active projects (transfer them first)

SSO Not Working

Check:

• SSO configuration correct
• Provider credentials valid
• Domain verified
• Test mode disabled

Member Cannot Access Project

Verify:

• Organization membership active
• Project access granted
• Correct role assigned
• Not suspended

Security Considerations

Access Control

• ✅ Regularly review team access
• ✅ Remove inactive members promptly
• ✅ Use 2FA for all members
• ✅ Monitor audit logs
• ✅ Use SSO when possible

Secret Management

• ✅ Limit who can view environment variables
• ✅ Rotate secrets when members leave
• ✅ Use project-level access control
• ✅ Audit secret access

Compliance

For compliance requirements:

• Enable audit logging
• Require 2FA
• Use SSO
• Set password policies
• Configure session timeouts
• Enable IP allowlist

Frequently Asked Questions

How many team members can I have?

Depends on your plan:

• Free: 1
• Pro: 3
• Team: 10
• Enterprise: Unlimited

Can I have different members for different projects?

Yes! Use project-level access control to assign specific members to specific projects.

What happens to projects when a member leaves?

You choose to either:

• Transfer to another member
• Transfer to yourself
• Delete the projects

Can I limit what team members can deploy?

Yes! Use deployment approvals and project-level access control.

How do I track what team members are doing?

Use:

• Activity logs
• Audit logs (Team plan+)
• Analytics dashboard
• Deployment history

Can external contractors access my projects?

Yes! Invite them as:

• Viewer (read-only)
• Member (for active work)
• Set expiration date on invitation

Next Steps