Skip to content
AM

Team: members and roles

Use Portal > Team at /team to invite teammates, manage pending invitations, assign roles, and suspend or remove access.

Invite a member

  1. Enter an email address.
  2. Select an assignable role.
  3. Select Invite Member.

The invitation reserves a seat. Membership is created only when the recipient accepts the tokenized invitation. Pending invitations can be resent or revoked.

The legacy MEMBER and VIEWER enum values both intentionally resolve to the built-in view-only role. New UI assignments use role slugs, which also support tenant-defined custom roles. The owner role cannot be assigned through an invitation or role change.

Change access

For a non-owner member, choose a role and select Save. The page calls updateMemberRoleBySlug, then refreshes the member and entitlement data.

Use Suspend to revoke organization access while retaining the membership record. A suspended member no longer consumes an active seat. Use Reactivate to restore access; reactivation fails with SEAT_LIMIT_REACHED if capacity is full.

Remove a member

Select Remove on the member row or details drawer and confirm. The removeMember mutation permanently deletes the membership and frees its seat.

Owners cannot be changed, suspended, or removed. The current product does not implement owner transfer or owner promotion in this surface, so there is no last-owner demotion workflow.

Seat display

The Team page shows:

  • Active seats used.
  • Pending invitations reserving seats.
  • Total seats on the subscription.
  • Remaining capacity.

When no seats remain, use role suspension, member removal, or invitation revocation to release capacity. The current InBlack UI does not include a dedicated seat-purchase control.

GraphQL operations

  • teamMembers(organizationId) and teamSeats(organizationId)
  • inviteMember(input) and bulkInviteMembers(input)
  • updateMemberRoleBySlug(userId, roleSlug)
  • suspendMember(userId) and reactivateMember(userId)
  • removeMember(userId)
  • pendingInvitations(organizationId) and revokeInvitation(id)

The current MCP catalog exposes inblack_set_member_role for member-role changes. It does not expose invite, remove, suspend, or seat-management tools.