# 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** view 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.