# Users

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

The **User** task in **Gaio DataOS** allows you to generate a table containing information about **all registered users** on the platform.\
This feature is particularly useful for access control, user management, governance reporting, and auditing flows based on user roles and permissions.

***

## How to Use

### **1. Open the Task**

Navigate to:\
**Tasks > ETL > User**

***

### **2. Define the Result Table Name**

* **Result table**: Enter the name of the table that will store the user data (e.g., `users_table`, `platform_users`, etc.).

***

### **3. Select the Desired Columns**

You can choose which user attributes to include in the output table:

| Column         | Description                                     |
| -------------- | ----------------------------------------------- |
| **Name**       | Full name of the user                           |
| **Email**      | Associated email address                        |
| **Created at** | Date the user account was created               |
| **Group**      | Group or permission set the user belongs to     |
| **Role**       | User access level (e.g., Admin, Editor, Viewer) |

> &#x20;Select only the fields you need for your process or report.

***

### **4. Save and Use**

* Click **Save** to add the task to your flow.
* Upon execution, the system will generate a table with **one row per user**, using the selected columns.

This table can be used for joins, permission validation, governance dashboards, or user-based filtering in flows and reports.

***

#### Use Cases

* Build governance dashboards to list all platform users
* Track user access levels, roles, and group associations
* Audit who has access to which environments or data
* Cross-reference users with logs or activity history


---

# 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.gaiodataos.com/tools/tasks/etl/users.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.
