Members and Roles

Business Accounts are in early access. See the overview for the model.

Members control who can administer the account. That is separate from who can sign. BusinessAccountMemberRole has three values:

Role	Can do
`owner`	Everything, including transferring ownership. Exactly one per account.
`admin`	Add and remove members and signers, and link wallets.
`viewer`	Read-only access.

Adding someone as a member does not let them sign, and adding a signer does not grant admin rights. Grant each explicitly.

Add a member

addMember adds a member as admin or viewer (it defaults to viewer). Identify them with a known userId, or with an identifier plus identifierType, in which case the user is created if they do not exist yet.

import com.dynamic.sdk.android.DynamicSDK
import com.dynamic.sdk.android.Models.BusinessAccountMemberRole
import com.dynamic.sdk.android.Models.BusinessAccountSignerIdentifierType

val sdk = DynamicSDK.getInstance()

val member = sdk.businessAccounts.addMember(
    businessAccountId = account.id,
    identifier = "admin@acme.com",
    identifierType = BusinessAccountSignerIdentifierType.email,
    role = BusinessAccountMemberRole.admin
)

println(member.userId)

String

required

The account to add the member to.

String?

A known Dynamic user ID. Use this instead of identifier.

String?

An email, phone number, or other identifier for the user.

BusinessAccountSignerIdentifierType?

How to read identifier: email, phoneNumber, externalUserId, socialUsername, socialAccountId, or id.

BusinessAccountMemberRole?

admin or viewer. Defaults to viewer.

List members

get returns the account with its members, including each member’s role.

val detail = sdk.businessAccounts.get(businessAccountId = account.id)

detail.members.forEach { member ->
    println("${member.userId}: ${member.role.name}")
}

Change a member’s role

updateMemberRole moves a member between admin and viewer. To change who the owner is, transfer ownership instead.

val updated = sdk.businessAccounts.updateMemberRole(
    businessAccountId = account.id,
    userId = member.userId,
    role = BusinessAccountMemberRole.viewer
)

Remove a member

val removed = sdk.businessAccounts.removeMember(
    businessAccountId = account.id,
    userId = member.userId
)

Removing a member also tears down any signer entries they held on the account’s wallets, so they lose signing access too, not just admin rights.

Transfer ownership

transferOwnership promotes an existing member to owner and demotes the current owner to admin in the same operation. Owner only.

val detail = sdk.businessAccounts.transferOwnership(
    businessAccountId = account.id,
    newOwnerUserId = newOwnerUserId
)

Transferring ownership revokes the caller’s session server-side, because their scope changed from owner to admin. The previous owner is signed out and must re-authenticate to pick up the new role. The new owner must already be a member.

Getting Started

Authentication

Wallets

Gasless

Business Accounts

Customizing Our UI

SDK Reference

Members and Roles

Add a member

List members

Change a member’s role

Remove a member

Transfer ownership

Next steps

Manage signers

Sign transactions

​Add a member

​List members

​Change a member’s role

​Remove a member

​Transfer ownership

​Next steps

Manage signers

Sign transactions

Add a member

List members

Change a member’s role

Remove a member

Transfer ownership

Next steps