Overview
Sharing workspace variables across Torq workspaces allows organizations to reuse centrally managed data across multiple automation environments. Instead of duplicating configuration or maintaining separate copies of the same data, teams can reference a single variable maintained in a source workspace.
Shared variables help maintain consistency across workflows while simplifying operational management. Because the variable is maintained in one location, updates made in the source workspace immediately apply wherever the variable is used.
Workspace variable ownership
When a workspace variable is shared, the source workspace retains full ownership of the variable. Only the source workspace can modify its value, structure, or configuration.
Destination workspaces receive a read-only version of the variable. They can reference and use it in workflows, but they cannot change it. This ensures that shared variables remain centrally controlled and consistent across workspaces.
Access and collaboration model
The workspace that shares the variable is referred to as the source workspace, and the workspace receiving the variable is the destination workspace.
Destination workspaces can use the shared variable in their workflows just like a local variable, but they cannot edit it. This separation allows teams to consume shared configuration data without risking unintended changes.
Prerequisites
Before sharing workspace variables across workspaces, ensure the following requirements are met:
Cross-workspace sharing enabled: Contact Torq Support to enable cross-workspace sharing for your organization.
Required role: You must have the Owner role in the source workspace.
Required permission: The role must include the
resource.sharescope.Destination workspace membership: You must be a member of the destination workspace to select it during the sharing process.
Automatic approval condition: If you are also an Owner in the destination workspace, the share request is accepted automatically. Otherwise, the destination workspace owners must review and approve the request.
How to use
The following sections explain how to share workspace variables, review share requests, and manage shared variables after they are distributed.
Share a workspace variable
Perform the following steps in the source workspace. You can also automate this process using the Create Share Request step.
Open workspace variables: Go to Build > Workspace Variables.
Select the variable: Locate the workspace variable you want to share.
Open sharing options: Open the three-dot (...) menu and select Share.
Select destination workspace: Choose the workspace to share the variable with and click Share. You can only select from workspaces where you are a member.
Submit the share request:
If you are also an Owner in the destination workspace, the request is accepted automatically.
Otherwise, an email is sent to the destination workspace owners asking them to review and accept the shared workspace variable.
Accept a share request
When a workspace variable is shared with your workspace, the workspace owners receive an email notification. Review the request before accepting it.
Open the request: In the email notification, click Review workspace variable. This opens the Workspace Variables page in Torq.
Review variable details: Examine the workspace variable information.
Approve or deny: Decide whether to accept or deny the variable. The user who shared the variable is notified of your decision by email.
Confirm availability: Once accepted, the workspace variable becomes available for use in workflows within the destination workspace.
(Optional) Automate decisions: Use the Accept Share Request or Deny Share Request steps to automatically process share requests.
Manage shared workspace variables
Shared workspace variables can be managed from both the source workspace and the destination workspace.
Revoke a shared workspace variable
Revoking a shared workspace variable removes access from the destination workspace. This action is performed in the source workspace.
Open variables: Go to the Workspace Variables page in the source workspace.
Locate the variable: Find the variable you want to revoke.
Open sharing options: Open the three-dot (...) menu and select Share.
Review shared workspaces: The modal lists all workspaces the variable is currently shared with.
Revoke sharing: Remove the selected workspace from the list.
Notify destination owners: An email is sent to the destination workspace owners informing them that the variable was revoked.
Remove a shared workspace variable
Removing a shared variable deletes the shared copy from the destination workspace.
Open variables: Go to the Workspace Variables page in the destination workspace.
Select the variable: Locate the shared workspace variable you want to remove.
Remove variable: Click Remove.
Notify source owners: An email is sent to the source workspace owners informing them that the shared variable was removed.
To automatically revoke or remove a shared variable, use the Remove Workspace Variable Sharing step.