Skip to main content

Members and Invitations

Members are the people who can access a workspace. New members are added by email invitation; only the invited address can accept the link.

Viewing members​

  • /workspaces/members — members of the workspace currently active in your context.
  • /workspaces/:workspaceId/members — members of a specific workspace (the URL workspace wins over context).

Each row shows the member's user ID and lets you select them for bulk actions. The active member count is displayed above the list. If you don't have workspace-member:list (and aren't allowed to invite), the page renders an Access Denied message.

Use the search box to filter by user ID. Pending invitations are summarized in a badge on the toolbar and listed in a separate section below the active members.

Inviting someone​

  1. Click Invite Member at the top of the members page (hidden or disabled without workspace-member:create).
  2. In the dialog:
  • Email Address — must be a valid email.
  • Roles (optional) — pick one or more from the available workspace roles. Roles tagged System are platform-defined; their descriptions appear under each role name.
  1. Click Send Invitation.

The invitee receives an email with a secure invitation link valid for 7 days. The invitation is rejected if the email is already an active member of the workspace.

Permissions: workspace-member:create.

Accepting an invitation​

When the invitee clicks the link they land on /workspaces/invite/:invitationId.

  1. Sign in first — if not authenticated, the page shows a Sign in to view your invitation card with a Sign In button that returns the user to this page after login. The invitee must use the same email address that received the invitation.
  2. The invitation details (email, expiry date and time, roles, invitation ID) are shown.
  3. The invitee clicks Accept Invitation or Reject.
  • On accept, they become a workspace member with the assigned roles and are taken to the workspace's members page.
  • On reject, they are returned to the workspaces list.

The page also handles non-pending states gracefully:

StateWhat the user sees
Already acceptedConfirmation, with a button to go to the workspace.
Already rejectedAcknowledgement, with a button back to workspaces.
Expired (past expiresAt)A note that the link is no longer valid; instructions to request a new one from the workspace admin.
Cancelled by senderA note that the invitation was cancelled; no further action available.
Not found / invalid IDAn invalid-link message with a button back to workspaces.
Network errorAn error card with Try Again and Go to Workspaces buttons.

Accepting an invitation is a public operation in the API — no extra workspace permission is required because the link itself is the authorization.

Managing pending invitations​

The Pending Invitations section on the members page lists every pending invitation for the workspace. Each row shows the invitee's email, the date it was sent, and a Pending badge.

You can:

  • Resend a single invitation — click Resend on its row. The email is regenerated and the 7-day expiry is reset.
  • Resend in bulk — tick the checkboxes (or Select all invitations) and click Resend Selected.
  • The selection count and a Clear selection button appear once you select anything.

Resending requires workspace-member:create (the button is disabled with a tooltip otherwise).

Cancelling and deleting invitations are supported by the backend (cancelInvitation, deleteInvitation) but are not yet exposed as buttons in the UI; ask an admin to invoke them via the API for now.

Removing a member​

  1. On a member row, select the checkbox.
  2. With one or more members selected, click Remove Selected in the bulk-action bar.
  3. Confirm in the prompt.

Removal is a soft-delete — the user loses access immediately but historical activity attributed to them is preserved. The workspace owner cannot be removed without first transferring ownership through an admin flow.

Permissions: workspace-member:delete.

Changing a member's roles​

Role changes go through the workspace RBAC service (updateWorkspaceMemberRoles). The members UI currently surfaces roles at invitation time only; ongoing role management is done through your tenant's RBAC tools.

Permissions: workspace-member:update.

Tips​

  • Roles come from your workspace's RBAC configuration. If you need a role that isn't listed, ask the workspace owner.
  • Invitations are workspace-scoped — accepting one only adds you to that single workspace.
  • The system blocks an invitation if the email is already a member of the workspace.
  • Pending-invitation lists, bulk resend selections, and member selections all clear automatically when you leave the page.