> For the complete documentation index, see [llms.txt](https://docs.codeocean.com/user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codeocean.com/user-guide/pipeline-guide/managing-pipelines.md).
# Managing Pipelines
## Sharing Pipelines
Sharing a Pipeline means that others can continue working from what you’ve developed—either in the same Pipeline or in a duplicate Pipeline.
You can set Pipeline permissions to collaborate with users and groups within your organization. Only authorized users can view/duplicate, or edit your Pipeline. Shared Pipelines are updated in near real-time with any changes made in the Pipeline.
It is best practice to utilize Group sharing to ensure that new users will have all relevant Pipelines available to them when they join, and that there will be no lost assets when team members leave. Reach out to your Admin to configure Groups through your company’s chosen Identity Provider.
{% hint style="info" %}
You can share a Pipeline with secrets/credentials just like any other Pipeline. To learn more about setting up secrets in Code Ocean, refer to the[ Secret Management Guide](/user-guide/compute-capsule-basics/secret-management-guide.md).
Navigate to [Running a Pipeline with Secrets](/user-guide/pipeline-guide/components-of-a-pipeline/capsules.md#running-a-pipeline-with-secrets) to learn how to run a shared Pipeline with a secret.
{% endhint %}
### Managing Pipeline Permissions
The three types of permission for a Pipeline are: Owner, Editor, and Viewer.
| Action | Viewer | Editor | Owner |
| --------------------------- | ------------------------ | ------------------------ | ------------------------ |
| View a Pipeline |
✅
|
✅
|
✅
|
| Download a Pipeline |
✅
|
✅
|
✅
|
| Export a Pipeline |
✅
|
✅
|
✅
|
| Edit files in a Pipeline |
❌
|
✅
|
✅
|
| Execute a Reproducible Run |
✅
|
✅
|
✅
|
| Edit Pipeline's permissions |
❌
|
❌
|
✅
|
| Delete a Pipeline |
❌
|
❌
|
✅
|
### Setting Permissions for Collaborators
1. Click Share at the top right corner of the Pipeline. A permissions setting form opens.
2. Type the name of the collaborator to invite or select the name from the drop-down menu. If groups are set up in your organization, they will also appear in the drop-down menu.
3. Click the desired user’s name/email address in the dropdown to add the collaborator. The system adds the user to the Pipeline permissions list. The permission is set as Viewer by default
4. To change a user's permissions or remove a user, click the down arrow next to the user, and choose the relevant option.
5. Click Save in the bottom right corner of the pop up to close the Pipeline permissions setting form.
6. To make a Pipeline visible to all internal users, under General Access, Everyone select Viewer
7. To share the Pipeline with Data Assets check Share Assets. To share only the Pipeline without Data Assets, ensure that Share Assets is deselected.
8. You can add more than one collaborator by repeating steps 2-3 before Saving.
#### **Modifying/Removing Collaborators from the Pipeline Permissions**
1. Click Share at the top right corner of the Pipeline. A permissions settings form opens.
2. Navigate to the collaborator you want to modify.
3. To change a user's permissions or remove a user, click on the drop-down menu next to the user, and select the relevant option.
4. Click Save to close the Pipeline permissions setting form.
### Owner/Admin Ability to Capture, Delete, and Rename Runs
Capsule Owners and Admins have the ability to rename and delete runs from other users, as well as create Result Data Assets from those runs. Code Ocean Admins also have the ability to see all runs on Release Capsules and rename or delete those runs.
### Working on a Shared Pipeline
#### View Mode
When you add a collaborator with the permission to view the Pipeline, the collaborator can view all the folders and files from the Pipeline IDE, download individual files, export, and duplicate the Pipeline.
To execute or modify code in the Pipeline as a Viewer, you will need to duplicate the Pipeline prior to editing.
Anyone with View Access can attach secrets to the Pipeline that is shared with them
#### Edit Mode
When you share a Pipeline with not edit permission, the collaborator can change any file's content and execute code in a Pipeline. Only one user can edit the shared Pipeline at any given time. All collaborators can view the same Pipeline simultaneously. When a collaborator is editing the Pipeline, all others will see the Pipeline in the view-only mode indicated by a message on top of the center section of the Pipeline IDE and the deactivated buttons in the right Timeline section.
Click Start editing to begin editing above the Editor in the center. If a collaborator's name appears in the message, they are forced into the read-only mode after your click.
{% hint style="info" %}
Before you Start edit the Pipeline when a collaborator appears to be editing, it is strongly recommended that you communicate with your collaborator in advance, so they don't lose their work.
{% endhint %}
## Duplicating a Pipeline
### How to create a private copy of either release or unreleased code
Duplicating a Pipeline allows you to create a copy of it while keeping the original unchanged. To duplicate a Pipeline:
1. Navigate to your My Pipelines Dashboard,
2. Click on the Pipeline you would like to duplicate, which will open the Pipeline IDE
3. Click Pipeline in the menu at the top of the screen
4. Select Duplicate. This process will create an exact copy of the Pipeline, which will be added directly to your My Pipelines Dashboard
## Archiving a Pipeline
Pipelines and Data Assets can be archived to reduce clutter in the Pipelines/Data Assets list. Archiving removes a Pipeline/Data Asset from the 'All' view, making them accessible through the Archive view.
1. Navigate to your **My Pipelines Dashboard**.
2. To archive a Pipeline directly from your dashboard, click the **Archive** icon associated with the relevant Pipeline
## Restoring an Archived Pipeline
Once a Pipeline is archived, it can be easily restored
1. To view your archived Pipelines, click the **Go to Archive** icon in top right of your **My Pipelines Dashboard** . All of your archived Pipelines will be listed on this screen.
4. To restore a Pipeline from the Archive, scroll the cursor over the Pipeline and click the **Restore Pipeline icon**.
5. Once all desired Pipelines have been restored, click Back to My Pipelines to return.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.codeocean.com/user-guide/pipeline-guide/managing-pipelines.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
