> For the complete documentation index, see [llms.txt](https://help.cerby.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cerby.com/cerby-web-app/secrets/managing-access-to-your-secrets/update-a-team-s-role-on-a-secret-or-secret-item.md).

# Update a team's role on a secret or secret item

{% hint style="info" %}
**Who can use this feature?**

* Workspace **Owners**, **Super Admins**, **Admins**, **Users**, and **Guest Users**
* Secret and secret item **Owners**
* Supported using the Cerby web app and mobile app. For the Cerby mobile app instructions, read the article [Update a team’s role on a secret using the Cerby mobile app](https://help.cerby.com/cerby-mobile-app/secrets/managing-access-to-your-secrets/update-a-team-s-role-on-a-secret)
  {% endhint %}

As a secret or secret item (such as WiFi, SSH keys, database, server, and custom item) **Owner**, you can update the role of other teams on your items using the Cerby web app. To do so, you must complete the following steps:

1. Log in to your corresponding [Cerby](https://app.cerby.com/) workspace.
2. Select the **Secrets** option from the left navigation drawer. The **Secrets** page is displayed.
3. Click the **Settings** (<img src="/files/RSJfXaY1vlWjF4iQSnII" alt="" data-size="line">) icon of the corresponding secret card. The secret details page is displayed with the **Settings** tab activated.\
   **NOTE:** If an identity challenge is configured, the **Confirm your identity to continue** dialog box is displayed, and a push notification is sent to your Cerby mobile app:
4. Confirm your identity by tapping the **It’s me!** button from the **Confirmation Request** screen of your Cerby mobile app. The **Confirm your identity to continue** dialog box closes in the Cerby web app, and the secret details page is displayed with the **Settings** tab activated.
5. Activate the **Teams** tab. The **Teams** section is displayed with a table of teams who have shared access to the secret or secret item.
6. Select the option from the **Cerby role** drop-down list that corresponds to the new role on the secret or secret item:
   * **Owner:** Teams can share access, edit, add attachments, and manage the secret settings.
   * **Collaborator:** Teams can only view the secret and download the attachments.

A success message box is displayed.

Now you are done.


---

# 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://help.cerby.com/cerby-web-app/secrets/managing-access-to-your-secrets/update-a-team-s-role-on-a-secret-or-secret-item.md?ask=<question>&goal=<endgoal>
```

`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.