Skip to main content

Workspaces​

Workspaces let you organize your organization's users and API keys into separate groups. Each workspace has its own set of API keys and user access controls, making it easier to manage permissions across teams or projects.

note

Workspaces are available on Enterprise plans. If you don't see the Workspaces option in your Settings sidebar, contact your Enigma representative to learn more.

View workspaces​

  1. Navigate to Settings > Access > Workspaces.

The Workspaces page lists all workspaces in your organization, sorted by creation date. Expand a workspace row to see its users and API keys.

Your organization has a default workspace, and each user has a current workspace that their console session operates in. You can switch your current workspace from the organization menu at the top of the sidebar.

Create a workspace​

Only organization Admins and Owners can create workspaces.

  1. Navigate to Settings > Access > Workspaces.
  2. Click Add workspace.
  3. Enter a name for the workspace. Optionally, select users to add to it right away.
  4. Click Add workspace.
note

Organizations are limited to 10 workspaces.

Rename or delete a workspace​

Expand a workspace to access its management controls:

  • Edit: Rename the workspace.
  • Delete: Permanently delete the workspace. You must type the workspace name to confirm. You can't delete your organization's only workspace, the default workspace, or the workspace you're currently in.
  • Set as current: Switch your session into this workspace.
  • Set as default: Make this the default workspace for your organization (new users and invitations are added to the default workspace).

Manage workspace users​

Each workspace has its own set of users with access to that workspace's resources.

Add users to a workspace​

  1. Navigate to Settings > Access > Workspaces and expand a workspace.
  2. Click Add users.
  3. Select the users you want to add.
  4. Click Add users.

Each user in a workspace has a workspace-level role (Admin or Member) that you can change from the dropdown in their row.

Remove users from a workspace​

  1. Navigate to Settings > Access > Workspaces and expand a workspace.
  2. Find the user in the workspace's user list.
  3. Click the actions menu (three dots) on the right side of their row.
  4. Select Remove.
note

Every user must belong to at least one workspace, so the Remove action is disabled when this is the user's only workspace.

Manage workspace API keys​

Each workspace can have its own API keys, separate from other workspaces.

Create an API key for a workspace​

  1. Navigate to Settings > Access > Workspaces and expand a workspace.
  2. Click Add API Key.
  3. Enter a name and description for the key. Admins can also choose the API key type: Service (shared, for applications) or Personal.
  4. Click Add API key.

You can reveal and copy a workspace API key at any time from the key's row using the view and copy buttons.

Delete an API key​

  1. Navigate to Settings > Access > Workspaces and expand a workspace.
  2. Find the API key in the workspace's key list.
  3. Click the actions menu (three dots) on the right side of its row.
  4. Select Delete and confirm with Delete API key.
warning

Deleting an API key cannot be undone. Any applications using the deleted key will immediately lose access.

note

The Delete action is disabled for your workspace's default key and for the last remaining key of a given type. Use the actions menu to edit a key or set it as the default instead.

Last updated on