Managing workspaces
Use shared workspaces to control access to and maintain isolation of assets, data, and ongoing work.
About workspaces
A workspace is an access-gated space within an organization where members can create projects, manage data, configure deployments, and conduct document reviews.
All members have a personal workspace, an area to test AI Hub capabilities and work on personal projects not tied to a specific business purpose. Your personal workspace is also the only workspace where you can create conversations. Organization admins can access personal workspaces if needed, but otherwise organization members can’t see or access the personal workspaces of other organization members.
Shared workspaces are collaborative workspaces where multiple members can work together with shared resources. Some members might work together to develop projects, others might conduct document reviews on run results, and another member might manage the workspace itself. Shared workspaces are membership-gated, meaning organization members must be granted access to a given workspace and its assets. Members can then be assigned workspace roles to control their permissions within a workspace.
Workspaces are also how you can create separation and data isolation between development and production-ready work. To support a software development lifecycle within AI Hub, organizations can have development workspaces and one or more production workspaces. Changes are then promoted between workspaces, ensuring ongoing development doesn’t impact production-ready projects, while still allowing for testing. Control and isolation of data is supported at the input and output level:
-
External drives can be connected at the organization or workspace level. The contents of workspace drives are accessible to only workspace members, ensuring managed access to drives used as a source of input files.
-
Workspaces can have workspace-specific default drives, letting you specify where to save all processed AI Hub files, such as automation project files and run results. You can use one drive to save data from your development and testing workspaces and a separate drive for data from your production workspace.
-
All apps and deployments are run within a workspace, ensuring access to run results—including results queued for human review in review-enabled deployments—is gated by workspace access.
Creating shared workspaces
Admins can create shared workspaces. There’s no limit to the number of shared workspaces in an organization.
-
Do one of the following:
-
In the header, click the initials icon, select Settings > Workspaces, then click Add workspace.
-
In Workspaces, click + Add workspace at the bottom of the workspaces list.
-
-
In the Workspace name field, name the workspace. Workspace names can include dashes, underscores, and alphanumeric characters, but not spaces. Workspaces can’t be renamed.
-
Click Create
-
Search for and select members or groups to add to the workspace, then click Next.
-
Select members to assign the workspace manager role, then click Add.
Managing shared workspace members
Because all workspace members can access all resources in the workspace, it’s important to control workspace access by managing the workspace members list. Both individual members and groups can be added to shared workspaces. If a group is added, all members of the group gain access.
Members can be added to a shared workspace multiple times, individually and through different groups. Because groups can be assigned workspace roles, it’s possible that a member is added to the same workspace multiple times, with different workspace roles. When multiple roles are assigned, the role with the highest privileges applies.
Adding workspace members
Admins can add organization members or groups to any shared workspace in the organization. Workspace managers can add members or groups to the workspaces they manage.
-
In the header, click the initials icon, then select Settings.
-
Click Workspaces, then select the workspace.
-
Click Add members.
-
Select a workspace role, then search for and select the members or groups to add to the workspace.
-
Click Add members.
Or, add workspace members in Workspaces.
-
In Workspaces, select the workspace.
-
Click Members, then click the add members icon
. -
Select a workspace role, then search for and select the members or groups to add to the workspace.
-
Click Add members.
Removing workspace members
When a member is removed from a shared workspace, they lose access to any work they’ve done in that workspace and any projects they might be collaborating on. When a group is removed from a workspace, all group members lose access.
-
In Workspaces, select the workspace.
-
Click Members, then locate the member or group in the members list.
-
Click the role dropdown, then select Remove access.
-
Click Confirm.
Or, remove access from the settings page:
-
In the header, click the initials icon, then select Settings.
-
Click Workspaces, then select the workspace.
-
In the member or group’s row, click the delete icon
. -
Click Confirm.
Designating production workspaces
Mark a workspace as production to indicate to other members that it’s used for operational data and workflows. Production workspaces display a visual indicator in the Workspaces tab. The production designation doesn’t affect access permissions or visibility settings.
For customers with a single-tenant environment, production workspaces receive priority when allocating resources to complete runs. By directing resources based on priority rather than queue order, you can ensure development and testing efforts in other workspaces don’t cause processing delays in your production workflows. When enabled, runs in non-production workspaces can take longer to complete than those in production workspaces, particularly when production workspaces have increased workloads.
-
In the header, click the initials icon, then select Settings.
-
Select the Workspaces tab then select the workspace.
-
Click Manage and turn on the Production workspace toggle.
Deleting shared workspaces
Deleting a shared workspace permanently deletes all projects, app runs, and other resources tied to the workspace. Workspace members lose access to all work created in the workspace. Any drives connected to the workspace are also disconnected.
-
In the header, click the initials icon, then select Settings.
-
Select the Workspaces tab then select the workspace.
-
Click Manage > Delete workspace.
-
Click Delete.
Viewing personal workspaces
Every organization member has their own personal workspace that admins can access if needed.
-
In the header, click the initials icon and select Settings.
-
Click Members to open the organization members list.
-
In the member’s row, click the overflow icon
, then select View personal workspace.
When viewing personal workspaces, some actions aren’t supported and some content, such as the Review tab, isn’t shown.