> For the complete documentation index, see [llms.txt](https://docs.cloudio.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudio.io/managing-roles-and-users/working-with-roles-and-users/creating-a-role.md).
# Defining a role
A role is used to provide controlled access to users, pages, workflow, data sources, java snippets, HTML requests and/or HTML templates.
{% hint style="info" %}
Roles can only be created and managed by the administrator.
{% endhint %}
To create a role,
1. In the upper right corner of the CloudIO homepage, in the menu bar, click. The **Navigation** page is displayed.
2. Under the **Administration** role, click **Manage Roles**. The **Manage Roles** page is displayed.
3\. In the upper right corner, click **Add Role**.
The role-details page is displayed.
4\. Enter the following details:
| User Detail | Description |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Role Name | The name of the role |
| Role Code | A unique code for the role that can be accessed from functions like hasRole() |
| Responsibility Id | The responsibility ID obtained from Oracle Apps
Note: This field is applicable only for Oracle EBS customers that is when the platform is configured using Oracle EBS.
|
| Application Id | The application ID obtained from Oracle Apps
Note: This field is applicable only for Oracle EBS customers that is when the platform is configured using Oracle EBS.
|
| Start Date | The start date for the role to be active |
| End Date | The end date for the role to be active |
| Auto Assign | Indicates that the role is to be automatically assigned to a newly created user |
| Is AD Group | Indicates that the **Authentication Provider** is of the type **Active Directory** |
| Is BI Enabled | Gives permissions to the role for using CloudIO dataSense 3.0 for creating and viewing reports |
5\. If required, assign one or more of the following components to the role through the respective tabs:
* Datasources
* Java Snippets
* HTML Requests
* HTML Templates
* Workflow Nodes
* Workflow Definitions
6\. Click **Save**. The role is created.
7\. To assign the created role with pages and/or users, in the respective section, click , select the required user(s) or page(s) and click **Save**.
The role is assigned to the selected users and/or pages accordingly.
---
# 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://docs.cloudio.io/managing-roles-and-users/working-with-roles-and-users/creating-a-role.md?ask=&goal=
```
`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.