# Role-based access for Flows

ZBrain Builder provides granular, role-based access control at the flow level, ensuring that users can view, edit, and execute only the flows appropriate to their assigned roles. This ensures secure and compliant handling of business logic and automation workflows across teams.

### **How role-based access works for Flows**

Each user’s interaction with flows is governed by their assigned role (Admin, Builder, Operator). Access can be customized further for each flow, ensuring tighter control over sensitive or critical processes.

| Role         | Flow access capabilities                                                                            |
| ------------ | --------------------------------------------------------------------------------------------------- |
| **Admin**    | Full control—create, modify, delete, run, and assign access to flows.                               |
| **Builder**  | Create and modify flows. Can test and execute the flows they’ve built or have been given access to. |
| **Operator** | View assigned flows. Cannot create, edit, or delete any flow. UI elements for editing are disabled. |

### **How to invite a user**

To invite a new user:

1. Click on the gear icon ⚙️ located at the top right corner of the ZBrain Builder interface and select ‘Settings’.

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

2. Go to the ‘Users’ section under ‘Settings’.
3. Select the ‘+Add’ button to add a new user. A side panel titled ‘Add New User’ appears on the right.

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

4. On the side panel, enter the first and last name of the user you want to invite.
5. Provide the person's email address and select the role to assign, Admin, Builder, or Operator.

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

6. Click ‘Invite.’

The user will receive the invitation message via email.

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

### **Granting a user access to a Flow**

1. Click on the invited user to open the Provide Access panel.

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

2. Use the search box to find the flow you want to grant access to.
3. Select the desired flow.
4. Click ‘Done’ to apply access.

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

The user will now see the assigned flow in their dashboard, with functionality aligned to their role.

### **How to modify the user access level**

To modify the details of the user:

1. Navigate to Settings > Users.
2. Click the pencil icon ✏️ next to the user.
3. In the ‘Edit User’ panel that appears, make the required changes:
   * First Name, Last Name, or Access Email
   * **Role:** Select the role that best fits the user’s responsibilities—Admin, Builder, or Operator.
   * **Status:** Switch the user’s status to Active or Inactive as required.
4. Click ‘Update’ to save the changes.

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

### **Flow visibility and restrictions**

* Users will only see flows to which they have been explicitly granted access.
* If a user’s role is downgraded (e.g., from Builder to Operator), editing capabilities will be automatically restricted for all flows, even if they were previously granted.
* Role changes take effect immediately across all associated flows.

This system ensures a secure and structured way to manage access across all flow-related activities in ZBrain Builder.


---

# 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/flows/role-based-access-for-flows.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.
