Mesrai Documentation - AI-Powered Code Review Platform

Mesrai

Managing Members

⚠️

**Important Note**: Organizations and Teams features are currently in active development. You may encounter some work-in-progress UI or experimental functionality as we refine these features for a mature production release.

Learn how to invite, manage, and remove members from your organization.

Member Overview

View all organization members:

Member name and email
Organization role
Team memberships
Join date
Last active
Activity stats

Organization Roles

Role Hierarchy

Owner (highest privilege)
  ↓
Admin
  ↓
Member (lowest privilege)

Owner Permissions

Full administrative control:

✅ All Admin permissions
✅ Delete organization
✅ Transfer ownership
✅ Manage billing and subscription
✅ Change organization settings
✅ Promote/demote admins
✅ Remove any member including admins

Limitation: Must have at least one Owner

Admin Permissions

Team and repository management:

✅ All Member permissions
✅ Invite/remove members (except Owners)
✅ Create/delete teams
✅ Connect/disconnect repositories
✅ View organization analytics
✅ Configure integrations
✅ Manage webhooks
❌ Change billing settings
❌ Delete organization
❌ Promote to Owner

Member Permissions

Basic access:

✅ View organization information
✅ Join teams (if invited)
✅ Access assigned repositories
✅ View team analytics (read-only)
❌ Invite other members
❌ Create teams
❌ Change settings
❌ Connect repositories

Adding Members

Via Email Invitation

Go to Organization Settings → Members
Click Invite Members
Enter email addresses (comma-separated)
Select organization role
Optionally assign to teams
Add invitation message
Click Send Invitations

Example:

Emails: alice@acme.com, bob@acme.com
Role: Member
Teams: Engineering, Frontend
Message: Welcome to ACME Engineering!

Via Domain Auto-Join

Enterprise feature - automatic joining:

auto_join:
  enabled: true
  domains:
    - acme.com
    - acme.io
  default_role: MEMBER
  auto_assign_teams:
    - all-hands

Anyone with verified @acme.com email automatically joins.

Via SSO Provisioning

SCIM-based automatic provisioning:

sso:
  provider: okta
  scim:
    enabled: true
    endpoint: https://api.mesrai.com/scim/v2
    token: scim_xxxxxxxxxxxxx

Members sync automatically from identity provider.

Bulk Import

Import multiple members via CSV:

Prepare CSV file:

email,role,teams
alice@acme.com,ADMIN,"Engineering,Backend"
bob@acme.com,MEMBER,"Engineering,Frontend"
charlie@acme.com,MEMBER,"QA"

Go to Members → Bulk Import
Upload CSV file
Review and confirm
Invitations sent automatically

Removing Members

Remove Individual Member

Go to Organization Settings → Members
Find member to remove
Click options menu (⋮)
Select Remove from Organization
Confirm removal

Consequences of Removal

When member is removed from organization:

✅ Loses access to all organization repositories
✅ Removed from all organization teams
✅ Can’t view organization analytics
✅ Removed from organization notifications
✅ Activity history preserved for audit
✅ Personal account remains active

Bulk Removal

Remove multiple members:

Go to Members page
Select members (checkboxes)
Click Bulk Actions → Remove Selected
Confirm removal
All selected members removed

Offboarding Checklist

When member leaves:

✅ Remove from organization
✅ Revoke API keys
✅ Remove from external integrations
✅ Transfer ownership of resources
✅ Archive activity logs
✅ Update documentation

Managing Roles

Changing Member Roles

Update organization role:

Find member in list
Click current role badge
Select new role from dropdown
Confirm change
Member notified of role change

Role changes take effect immediately.

Role Change Restrictions

❌ Can’t remove last Owner
❌ Members can’t promote themselves
❌ Admins can’t promote to Owner
✅ Owners can change any role
✅ Admins can change Member roles

Transferring Ownership

Transfer organization ownership:

Current Owner goes to Settings → Ownership
Click Transfer Ownership
Select new Owner (must be existing Admin)
Confirm transfer with password
New Owner receives confirmation email
Original Owner becomes Admin

Warning: This action cannot be undone.

Team Membership

Organization members can join teams:

Direct Team Assignment

Add member to teams:

Go to member profile
Click Team Membership
Select teams to add
Optionally assign team role
Save changes

Team Invitation

Teams can invite organization members:

Team admin sends invitation
Member receives notification
Member accepts/declines
Added to team upon acceptance

Learn more about teams →

Member Activity Tracking

Activity Metrics

Track member activity:

Reviews Participated: PRs reviewed
Comments Made: Feedback given
Repositories Accessed: Repos viewed
Teams Joined: Team memberships
Last Active: Most recent action

Activity Timeline

View chronological actions:

2025-01-15 10:30 - Joined Engineering team
2025-01-15 11:45 - Reviewed PR #234
2025-01-15 14:20 - Added comment on PR #230
2025-01-16 09:15 - Connected repository

Inactive Members

Identify inactive members:

No activity in 30+ days
No reviews participated
No teams joined
Never accessed repositories

Consider removing or reaching out.

Member Permissions

Repository Access

Control repository access:

Organization-Level

All members can access all repos (default)
Restrict to team-based access only

Member-Level Override

member: alice@acme.com
repositories:
  - repo-a: admin
  - repo-b: write
  - repo-c: read

Feature Access

Control feature availability:

Feature	Owner	Admin	Member
View Analytics	✅	✅	✅ (read-only)
Export Data	✅	✅	❌
Manage Teams	✅	✅	❌
Connect Repos	✅	✅	❌
API Access	✅	✅	Limited
Webhooks	✅	✅	❌
Billing	✅	❌	❌

API Key Management

Per-member API keys:

# Generate API key for member
POST /v1/organizations/{orgId}/members/{memberId}/keys
{
  "name": "CI/CD Pipeline",
  "scopes": ["reviews:read", "repositories:write"],
  "expiresIn": "90d"
}

Member Settings

Per-Member Configuration

Notification Preferences

Email frequency: Real-time, Daily, Weekly
Slack mentions: Enabled/Disabled
In-app alerts: Enabled/Disabled

Review Settings

Auto-assign reviews: Yes/No
Review focus areas: Security, Performance, etc.

Access Restrictions

Allowed repositories: All or specific
API access level: Full, Limited, None
IP whitelist: Optional

Search & Filtering

Search Members

Find members quickly:

Search by name
Search by email
Search by team
Search by role

Filter Members

Apply filters:

By Role: Owner, Admin, Member
By Status: Active, Inactive, Invited
By Team: Engineering, Product, etc.
By Join Date: Last 7/30/90 days
By Activity: Active, Low activity, Inactive

Bulk Operations

Bulk Role Changes

Update roles for multiple members:

Select members
Click Bulk Actions → Change Role
Choose new role
Apply to selected
Confirm changes

Bulk Team Assignment

Add multiple members to teams:

Select members
Click Bulk Actions → Add to Teams
Select teams
Optionally assign team roles
Apply changes

Bulk Notifications

Send message to multiple members:

Select members
Click Send Message
Compose notification
Choose delivery method (email, in-app, Slack)
Send

Troubleshooting

Member Can’t Access Organization

Problem: Member sees “Access Denied”

Solutions:

Verify member accepted invitation
Check member’s email matches invitation
Ensure member is not removed
Verify organization visibility settings

Can’t Change Member Role

Problem: Role dropdown disabled

Solutions:

Check your role (need Owner or Admin)
Can’t demote last Owner
Admins can’t promote to Owner
Contact organization Owner

Member Receiving Too Many Notifications

Problem: Member overwhelmed with notifications

Solutions:

Update notification preferences
Configure email digest instead of real-time
Disable certain notification types
Use team-level notification settings

SSO User Can’t Join

Problem: SSO enabled but user can’t join

Solutions:

Verify SSO configuration
Check user email domain matches verified domains
Ensure user authenticated via SSO
Check SCIM provisioning status

Best Practices

1. Least Privilege Principle

Start with minimal access:

New members → Member role
Promote based on needs
Regular role audits
Document promotion criteria

2. Regular Audits

Quarterly review:

Remove inactive members
Verify role appropriateness
Check team memberships
Review API key usage

3. Clear Onboarding

When new member joins:

✅ Send welcome email
✅ Share organization guidelines
✅ Assign to relevant teams
✅ Schedule intro meeting
✅ Grant necessary access

4. Proper Offboarding

When member leaves:

✅ Remove organization access
✅ Transfer resource ownership
✅ Revoke API keys
✅ Remove from external integrations
✅ Export activity logs

API Reference

List Members

GET /v1/organizations/{orgId}/members
 
Response:
{
  "members": [
    {
      "id": "user_123",
      "email": "alice@acme.com",
      "role": "ADMIN",
      "joinedAt": "2025-01-01T00:00:00Z",
      "lastActive": "2025-01-15T10:30:00Z",
      "teams": ["team_eng", "team_backend"]
    }
  ]
}

Update Member Role

PATCH /v1/organizations/{orgId}/members/{memberId}
{
  "role": "ADMIN"
}

Remove Member

DELETE /v1/organizations/{orgId}/members/{memberId}

Bulk Invite

POST /v1/organizations/{orgId}/members/bulk-invite
{
  "invitations": [
    {
      "email": "alice@acme.com",
      "role": "ADMIN",
      "teams": ["team_eng"]
    }
  ]
}

Next Steps

Support

Need help managing members?

Creating Organizations Organization Settings