Roles
The first user to install the GitHub App for an org or personal account becomes admin. Every subsequent teammate must accept an invite — signing in with GitHub alone is not enough. Every workspace must keep at least one admin — you cannot demote or remove the last admin without promoting someone else first.
Invite a teammate
1
Open Team settings
Go to lanesync.dev → Settings → Team tab. Only admins see the Invite Member button.
2
Generate an invite link
Click Invite Member. LaneSync calls Copy the link and send it to your teammate (Slack, email, etc.). New invites default to the member role.
POST /api/team/invite and returns an HMAC-signed link:3
Teammate accepts the invite
Your teammate signs in to LaneSync with GitHub OAuth and opens the invite link. LaneSync verifies the signature and expiry, then adds them to the workspace.Their session switches to the invited workspace automatically.
Change a member’s role
- Go to Settings → Team
- Find the member in the table
- Click Promote to Admin (shield-plus icon) or Demote to Member (shield-minus icon)
PATCH /api/team/:userId/role with { "role": "admin" } or { "role": "member" }.
Remove a member
- Go to Settings → Team
- Click the Remove (trash) icon next to the member
- Confirm in the dialog
DELETE /api/team/:userId. Admins cannot remove themselves — delete the workspace or transfer admin first.
Troubleshooting
Invalid or expired invite link
Invalid or expired invite link
Ask an admin to generate a new invite. Links expire 7 days after creation.
Cannot demote the last admin
Cannot demote the last admin
Promote another member to admin first, then demote the original admin.
Teammate cannot see the workspace
Teammate cannot see the workspace
Confirm they opened the full invite URL while signed in with the correct GitHub account. They must accept the invite — merely signing in is not enough.
Related
Dashboard overview
What teammates see after joining.
Billing and plans
Pro upgrades and workspace limits — admin only.