Skip to content

Members and Roles

Membership in an organization is managed from Organizations → (your org) → Settings. This page covers how to invite users, what each role can do, and how granular per-member permissions work.

Inviting someone to the org sends them an email-addressed invitation that they accept from their Sigvault Inbox.

To invite a member:

  1. Open the org and go to Settings.
  2. In the Invites section, enter the invitee’s email address.
  3. Choose a role (Admin or Member).
  4. For Member invites, select the permissions the new member should have.
  5. Send the invite.

The invitee will see the pending invite in their Inbox the next time they sign in (or immediately if they’re already signed in). They can Accept or Decline. Pending invites that aren’t accepted before their expiry are marked EXPIRED automatically.

You can revoke a pending invite at any time from the Invites section.

Sigvault has two roles inside an organization:

RoleWhat it can do
AdminFull control over the organization — including managing members, settings, webhooks, and creating vaults.
MemberWhatever is granted by the explicit per-member permissions list (see below).

An Admin always has every permission implicitly. A Member starts with no permissions and is granted them individually.

A Member’s capabilities come from an explicit list of permissions on their membership. Permissions are grouped by the resource they apply to.

PermissionAllows
device:createRegister a new device into the org’s device pool
device:updateRename or update device metadata
device:deleteRemove a device from the org
device:shareShare or revoke device shares for devices the user owns
device:remote_sessionOpen a remote signing session against an org device
PermissionAllows
wallet:createBuild a new vault inside the org
wallet:readView vault details, balances, and history
wallet:updateEdit wallet metadata
wallet:deleteRemove a vault from the org
wallet:transactions:readView transaction history
wallet:addresses:readView receive addresses
PermissionAllows
draft_tx:createInitiate a new outgoing transaction (build a PSBT)
draft_tx:cancelCancel a pending draft transaction
tx:signParticipate in the signing ceremony
tx:broadcastBroadcast a fully-signed transaction
PermissionAllows
members:inviteSend and revoke invites
members:manageAdd, remove, and change roles of existing members
settings:manageChange organization settings
webhooks:manageConfigure outbound webhooks
walletrs_agent:manageManage walletrs agent bindings

The dashboard provides presets that map to typical roles:

  • Viewer — read-only access (wallet:read, wallet:transactions:read, wallet:addresses:read)
  • Signer — can sign transactions but not initiate them (wallet:read, tx:sign)
  • Initiator — can build and broadcast transactions but not change membership (wallet:*, draft_tx:*, tx:*)
  • Custom — explicit checkboxes for each permission

You can always edit a member’s permissions later from the Members section.

From Settings → Members, click the edit icon on any member row. You can:

  • Promote a Member to Admin (or demote an Admin to Member, as long as another Admin remains)
  • Change the permissions list for a Member
  • Remove the member from the org entirely

Permission changes take effect immediately on the next request from that user.

A member can remove themselves from an organization from Settings → Members → (your row) → Remove. The last remaining Admin cannot leave — they must promote someone else first.

Leaving an org does not delete or affect any wallets the org operates. Vaults built from your device’s key remain functional unless you also revoke the device share.