Overview
Sharing integrations across Torq workspaces allows organizations to reuse existing connections while maintaining centralized ownership and control. Instead of recreating integrations in each workspace, teams can share them from a source workspace to destination workspaces, reducing duplication and ensuring consistent configuration across environments.
Shared integrations behave the same as integrations created directly within the destination workspace. Teams can use them in workflows, triggers, or steps without additional configuration, while the source workspace continues to manage the integration settings.
Supported integration types
The following integration types can be shared across workspaces:
Step integrations
Trigger integrations
Secrets
Once shared and accepted, these integrations are available for use in the destination workspace just like locally created integrations.
Ownership and access control
The workspace that shares the integration is the source workspace, and the workspace receiving it is the destination workspace. The source workspace retains full control over the integration configuration.
Destination workspaces can use the shared integration but cannot modify its settings. This model ensures that integrations remain centrally managed while still enabling teams to use them across multiple workspaces.
Prerequisites
Before sharing integrations across workspaces, ensure the following requirements are met:
Enable cross-workspace collaboration: Contact Torq Support to enable cross-workspace sharing for your organization.
Required role: Users must have the Owner role to share workspace resources.
Required permission: The role must include the
resource.sharescope.Automatic approval condition: If the user sharing the integration is also an Owner in the destination workspace, the share request is accepted automatically.
Manual approval condition: Otherwise, the destination workspace owners receive an email requesting that they review and approve the shared integration.
How to use
The following sections explain how to share integrations, review share requests, and manage shared integrations.
Share an integration
Perform the following steps in the source workspace. You can also automate this process using the Create Share Request step.
Open integrations: Go to the Integrations page and select the integration type you want to share.
Locate the integration: Find the specific integration instance in the list.
Open sharing options: Open the three-dot (...) menu and select Sharing.
Select destination workspace: Choose the workspace to share the integration with and click Share. You can only select from workspaces where you are a member.
Submit the 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 integration.
Accept a share request
When an integration is shared with your workspace, the workspace owners receive an email notification. Review the integration before accepting the request.
Open the request: In the email notification, click Review integration.
Review integration details: In Torq, review the integration information.
Approve or deny: Decide whether to accept or deny the integration. The user who shared the integration is notified of your decision by email.
Confirm availability: Once accepted, the integration becomes immediately available for use in the destination workspace.
(Optional) Automate decisions: Use the Accept Share Request or Deny Share Request steps to process share requests automatically.
Manage shared integrations
Shared integrations can be managed from both the source workspace and the destination workspace.
Filter shared integrations
You can filter integrations to see which ones are shared to or from the workspace.
Open integrations: Go to the Integrations page.
Apply shared filter: Use the Shared filter at the top of the page.
Select integration type: Choose the integration type you want to view.
Review sharing status: The Shared column indicates whether the integration is shared to or from the workspace.
Revoke a shared integration
Revoking an integration removes access for the destination workspace. This action is performed in the source workspace.
Open integrations: Go to the Integrations page and select the integration type.
Locate the integration: Find the integration in the list. The Shared column should indicate that the integration is shared from the workspace.
Open sharing settings: Open the three-dot (...) menu and select Sharing.
Review shared workspaces: The modal lists all workspaces the integration 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 integration was revoked.
Remove a shared integration
Removing a shared integration deletes the shared copy from the destination workspace.
Open integrations: Go to the Integrations page and select the integration type.
Locate the integration: Find the integration in the list. The Shared column should indicate that the integration is shared to the workspace.
Remove the integration: Open the three-dot (...) menu and select Remove.
Notify source owners: An email is sent to the source workspace owners informing them that the integration was removed.
To automatically remove or revoke a shared integration, use the Remove Integration Sharing step.