# User management

ZBrain allows role-based user permissions for every agent and agent crew, enabling granular access control. Admins can configure which users are allowed to build or operate a specific agent or agent crew.

### **Accessing user management** <a href="#accessing-user-management" id="accessing-user-management"></a>

To open the user management panel for any agent or agent crew:

1. Go to the ‘Agents’ section.
2. Click on the agent or agent crew for which you want to set up user permissions.

<figure><img src="/files/rxiOR6dhStC1e8pj3p4q" alt=""><figcaption></figcaption></figure>

3. You will be redirected to the selected agent’s dashboard.
4. Click the gear icon in the bottom-left corner of the screen to open the ‘Settings’ panel of that specific agent/agent crew.
5. From the left menu, select ‘User Management’. This opens the user management interface.

<figure><img src="/files/13tt02C5txxu5vZb2r2I" alt=""><figcaption></figcaption></figure>

### **User roles** <a href="#user-roles" id="user-roles"></a>

Two roles can be assigned to users:

* **Builder**: Can edit the agent’s configuration, including queue, flow, and output settings.
* **Operator**: Can run and monitor the agent, but cannot edit its configuration.

Each role provides two assignment modes:

* **Custom**: Manually search and invite specific users.
* **Everyone**: Grants the role to all users in the workspace.

### **Assigning Users** <a href="#assigning-users" id="assigning-users"></a>

For each role:

1. Choose ‘Custom’ or ‘Everyone’.
2. If ‘Custom’ is selected:
   * Use the search field to find users by name.
   * Click ‘Invite’ to assign the role.
3. Once invited and accepted, the user gets access to the agent under the assigned role.


---

# 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://docs.zbrain.ai/zbrain-documentation/zbrain-builder/zbrain-ai-agents/user-management.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.