Skip to main content
Share Workspace Variables Across Torq Workspaces

Learn how to share workspace variables across workspaces in Torq to enable seamless collaboration.

Updated over a week ago

Sharing a workspace variable enables the selected workspaces to use the variable in their workflows. The shared variable is read-only, meaning that shared resources can only be edited in the source workspace.

  • To enable cross-workspace collaboration for your organization, contact Torq support. Once enabled, users with the Owner role (the relevant scope is resource.share) can share workspace resources.

  • The share request will be accepted automatically if the user sharing the resource is also an Owner in the destination workspace.

1. Share a Workspace Variable

Perform these steps in the source workspace. To automatically share a workspace variable, use the Create Share Request step.

  1. Go to Build > Workspace Variables and select the workspace variable you want to share.

  2. Click the sharing icon.

  3. Select the workspace to share the variable with and click OK. You can only select from the workspaces you are a member of.

  4. The share request is automatically accepted if you’re also an Owner of the destination workspace. Otherwise, an email is sent to the destination workspace owners requesting that they review and accept the shared workspace variable.

2. Accept the share request

Follow these steps when you receive an email saying a workspace variable was shared with your workspace. To automatically accept or deny a share request, use the Accept Share Request or Deny Share Request steps, respectively.

  1. In the email, click Review workspace variable.
    This will open the Workspace Variables page in Torq.

  2. Review the workspace variable information.

  3. Decide whether to accept or deny the workspace variable. The user who shared the workspace variable will be notified of your choice by email.

  4. If accepted, the workspace variable is ready to use in the destination workspace at this stage.

3. Manage Shared Workspace Variables

Revoke a Shared Workspace Variable

Revoke a shared workspace variable from the source workspace:

  1. Go to the Workspace Variables page and locate the variable you want to revoke.

  2. Click the Sharing icon.

  3. All the workspaces with which the workspace variable is currently shared are listed at the bottom of the modal.

  4. You can revoke the workspace variable from any workspace.

  5. An email will be sent to the destination workspace owners to notify them that the workspace variable was revoked.

Remove a shared workspace variable

Remove a workspace variable that’s shared to your workspace:

  1. Go to the Workspace Variables page and select the variable you want to remove.

  2. Click Remove.

  3. An email will be sent to the source workspace owners to notify them that the workspace variable was removed.

Use the Remove Workspace Variable Sharing step to automatically remove or revoke a shared workspace variable.

Did this answer your question?