Workspaces

A workspace is an isolated operating environment within your organisation, on a single Bitcoin network. It has its own users, roles, vaults, assets, policies and audit history, and a role in one workspace grants nothing in another.

Updated 08 Nov 20261 min read

Common reasons to create separate workspaces: a separate stablecoin programme, distinct governance boundaries for different teams, or a testnet workspace for training and pre-production testing.

#Creating a workspace

Required permissions: Create workspace (CREATE_WORKSPACE) and Manage workspace (MANAGE_WORKSPACE) in your current workspace.

  1. Open the workspace selector and select Add Workspace.
  2. Enter a name. Use letters, numbers, hyphens and underscores, for example treasury-ops or USDX_issuance.
  3. Enter a description of 20 to 255 characters.
  4. Select the network: Mainnet for live operations, or Testnet for training and testing.
  5. Select Create.

You are added to the new workspace automatically, as Owner if you are an organisation owner and as Admin otherwise. Invite users, set up roles and create a vault before you operate.

warning:

The network is permanent

A workspace's network applies to every vault and asset in it and cannot be changed. Mainnet involves real Bitcoin and real token issuance. Use testnet for training and testing only.

#Workspace details

A workspace's name, description and network are fixed when you create it. Settings shows them for reference.

Key takeaway

A workspace is a self-contained boundary for users, roles, vaults, assets, policies and audit history. Plan workspaces around the governance boundaries you need, because their network and identity are set at creation.

Was this page helpful?