Share integrations
  • 07 Jan 2024
  • 2 Minutes to read
  • Dark
    Light

Share integrations

  • Dark
    Light

Article Summary

You can share the following types of integrations: steps, triggers, and secrets with other workspaces. Shared integrations function just like those created directly within the workspace.

IMPORTANT
  • 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.
  • If the user sharing the resource is also an Owner in the destination workspace, the share request will be accepted automatically.

1. Share an integration

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

  1. Go to the Integrations page and select the type of integration you want to share.
  2. Locate the specific integration instance and select Sharing from the three-dot menu.
    Select a specific integration instance and in the three dots menu select Sharing
  3.  Select the workspace to share the integration with and then click OK. Remember that you can only select from the workspaces you are a member of.
    Select the workspace to share the integration with
  4. If you're an Owner in the destination workspace as well, the share request is automatically accepted and the integration will become available in the destination workspace. Otherwise, an email is sent to the destination workspace owners requesting that they review and accept the shared integration.
    Select to review the shared integration

2. Accept the share request

Follow the steps below when you receive an email saying an integration 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 integration
  2. In Torq, review the integration information. 
  3. Decide whether to accept or deny the integration. The user who shared the integration will be notified of your choice by email.
  4. If it's accepted, the integration is ready to use in the destination workspace at this stage.
    Accept the shared integration

3. Manage integrations shared to or from your workspace

Manage shared integrations:

  • Filter out shared integrations
  • Revoke a shared integration (from the source workspace)
  • Remove a shared integration (from the destination workspace)

To automatically remove or revoke a shared integration, use the Remove Integration Sharing step.

Filtering out shared integrations

To see which integrations are shared to or from the workspace, use the Shared filter at the top of the Integrations page.

  1. Select the filter value.
    Use the Shared filter to see integrations shared to or from the workspace
  2. Select the integration type.
  3. The Shared column will show which integrations are shared to or from the workspace.
    Shared column

Revoke a shared integration

You can revoke a shared integration from the source workspace by following these steps:

  1. Go to the Integrations page and select the type of integration you want to revoke.
  2. Locate the integration in the list. The Shared column should show the integration is shared from the workspace.
  3. Go to the three-dot menu and select Sharing.
  4. All the workspaces the integration is currently shared with are listed at the bottom of the form.
  5. You can revoke the integration from any workspace.
  6. An email will be sent to the destination workspace owners to notify them that the integration was revoked.

Revoke an integration

Remove a shared integration

You can remove a shared integration from the destination workspace by following these steps:

  1. Go to the Integrations page and select the type of integration you want to remove.
  2. Locate the integration in the list. The Shared column should show the integration is shared to the workspace.
  3. From the three-dot menu, select Remove.
  4. An email will be sent to the source workspace owners to notify them that the integration was removed.

Remove a shared integration


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.