This section provides an overview of sharing principles, limitations, and approaches.

Sharing Model

Owners and collaborators

The following are the basic types of users of a shared object:

Shareable Objects

The following types of objects can be shared with other workspace users:

• Flows
• Connections

• Plans

Sharing Flows

In the collaborative approach, two or more users can work on the same flow. When a flow is shared, all flow objects are shared, including:

• Imported datasets

  NOTE: A dataset that is created with parameters cannot be modified by a collaborator. It can only be modified by the owner.

• Recipes
• Job results

• Webhook tasks

All collaborators have access to the above objects, as long as they have permissions to the underlying sources. See below.

Use cases:

• Distribute the work on a flow with multiple recipes among team members for faster throughput.
• Pass recipes to others for commenting, editing, and general review. 
• When stuck, share the flow with the team expert to provide guidance.

Permissions

Underlying datasets: Sharing a flow does not change the permissions to the underlying data. If a user with whom a flow has been shared does not have access to the data on the datastore, the user cannot work with the flow's datasets.

• Datasets that are accessed through private connections cannot be shared, unless the connection is also shared.
• Stricter permissions sets on the datastore can adversely affect users' ability to access shared flows.

Sharing samples: Samples are not shared when a flow is shared. Users that have been shared a flow must create their own samples.When flows are shared with you, you can access them through the Shared with Me tab in the Flows page. See Flows Page.

Editor permissions:

• Datasets
  • Use the imported datasets and references as sources in other flows accessible to the collaborator.
  • Add new imported datasets.
  • Remove existing imported datasets.
  • Change the source of datasets.
  • Edit dataset names and descriptions.
• Recipes
  • Add new recipes.
  • Edit the existing recipes, including multi-dataset operations such as union or join.
  • Delete recipes.
  • Copy recipes within the shared flow.
  • Move recipes to the shared flow.
  • Move recipes out of the shared flow.
  • Run jobs.

Viewer permissions:

• User can access the flow and run jobs.
• User cannot modify the flow.

Collaborator (Editor and Viewer) limitations:

Collaborators do not have the following permissions on a flow shared with them:

• Flow
  • Delete the flow
  • Edit the name and description of the flow
  • Remove the flow owner's access to the flow
• Datasets
  • Delete imported datasets

  • Modify imported datasets

    NOTE: Collaborators cannot modify datasets created with custom SQL.

Editing recipes

Owners and Editors have the same permissions to edit recipes in the shared flow. In the Edit History, edits appear under the usernames of the individual contributors.

Removing access

You can remove sharing access to a flow. When a flow is no longer shared with a user, that user:

• Cannot see the flow or its objects
• Cannot access them, if the user knows the location of the objects

Share Connections

When initially created, a connection is private. It is accessible only to the user who created. it.

Through the Connections page, you can share your connections with other users:

• Share connection with individual users: You can share your connection with specified workspace users.
  • You can also share connections that have been shared with you.

When connections are shared with you, you can access them through the Shared with Me tab in the Connections page. See Connections Page.

Sharing credentials:

When shared, private connections can be shared with or without credentials. If credentials are not shared, new users of the shared connection must supply their own credentials. Those credentials must be permitted access if access to any datasets previously imported through the connection is required.

For more information, see Connections Page.

Sharing connections through flows:

When a flow is shared, any connections associated with it are automatically shared to the specified users. If the connection is configured to do so, credentials are included, so that the new users can immediately begin using the flow.

For more information, see Flow View Page.

Share Plans

Plans that you create can be shared with other users. In the Plans page, select Share from a plan's context menu.

Depending on whether you created the plan, you may have the following set of privileges:

When a plan is shared with you, you are a collaborator on the plan. A collaborator has the following capabilities based on the plan privileges assigned to your workspace role:

For more information, see Share a Plan.