Skip to main content

Share Step Runners Across Torq Workspaces

Learn how to share Step Runners across workspaces in Torq to enable seamless collaboration.

Updated over 2 weeks ago

You can share Step Runner instances across workspaces.

To enable cross-workspace collaboration for your organization, contact Torq support to explore licensing options. Once enabled, users with the Workspace Owner or Workflow Builder role with the resource.share scope can share workspace resources.

Workloads running on shared Step Runners utilize the resources of the original Step Runners. Sharing Runners across workspaces may exhaust the Runner resources, potentially impacting performance and/or causing step failure.

Once a Step Runner is shared, the event is logged within the Audit Logs in the parent workspace.

Share Step Runners

The share request will be accepted immediately if the user sharing the resource is also an Owner in the destination workspace. To automatically share a Step Runner, use the Create Share Request step. To manually share a Step Runner:

  1. Navigate to the Step Runner: In Torq, go to Integrations > Runner in the source workspace and click on the More options menu for the relevant Runner.

  2. Share the Runner: Click Share.

    1. Select the relevant destination workspace.

    2. Click OK.

Accept share requests

You will receive an email confirming the Step Runner 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. Review the Runner: In the email, click Review Step Runner. This will open the Step Runners page in Torq.

  2. Accept the request: Decide whether to accept or deny the Runner. The user who shared the Runner will be notified by email and the Runner will be ready for immediate use in your workspace.

Remove Shared Step Runners

You can automatically remove a Step Runner with the Remove Runner Sharing step. To manually remove a shared Step Runner from your workspace:

  1. Navigate to the Step Runner: In Torq, go to Integrations > Runner in the destination workspace and click on the More options menu for the relevant Runner.

  2. Delete the Runner: Click Remove shared runner. An email will be sent to the source workspace owners to notify them that the Runner was removed.

Did this answer your question?