> 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-user-s-role-on-a-secret-or-secret-item.md).

# Update a user'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 the Cerby mobile app
  {% 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 workspace members 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/eZ61KyoQvtgZW3FGcS0V" 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 **Members** tab. The **User Overview** section is displayed with a table of users 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:** Members can share access, edit, add attachments, and manage the secret settings.
   * **Collaborator:** Members can only view the secret and download the attachments.

   **IMPORTANT:** Users who have received shared access to the same secret or secret item multiple times appear with the **Mixed role** status in the **Cerby role** column. When clicking the drop-down list, the **Share secret** dialog box is displayed with each access grant and role. You can only update the role if shared access is via a direct grant to the secret or a collection to which you have the **Owner** role.

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